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M.P.G. USERS’ MANUAL 


1.0 INTRODUCTION 


(1.1 


1.2 


1.3 


This Manual contains all information necessary for use and 
operation of — Maintenance Program apuerese’ (MPG) ecegr ee. 

prectaes hardware oriented tethnical personne] with’ the 
ability to easily generate and execute programs on the PDP-11 
series of computers. While these programs ay be written so as 
to perfora any type of task, the major application expected are 
sheen that aid in the maintenance and repair of peripheral 
evices. 


Appendiz H of this manual contains a summary of the capabilities 
an pupeer's provided on the initial release of - Also 
contained in this Appendiz is the changes incorporated in 
subsequent releases (versions) of . 


RELATED PROGRAMS 


The XXDP Update Program 8 2 (UPD2 - MAINDEC # 11-DZQUB-H) is used 
for certain MPG media maintenance and creation functions. In 
addition, MPG is supplied on media and therefore is preceded 
by execution of the applicable XXDP Monitor. 


RELATED DOCUMENTS 


For details concerning the operation of the XXDP Monitor and _ the 
ee ro ty refer to the XXDP User’s Manual (MAINDEC #8 


Toorg is now available from SDC an MPG Summary Manual 
(11 TSHA-A-D) which consists of excerpts from this document. It 
is considerably smaller in size and contains summarized 
information concerning MPG loading, commands, instructions, 
buffer areas, patterns, and Device Routines. This manual assumes 
a knowledgable MPG user. 


ORDERING INFORMATION 


The files which comprise MPG are integral components of the XXOP 
Multi-Media system. When all items of certain XXDP packages are 
ordered, MPG’s binecy files will be included. However, 

pet ieas and/or binary files can be ordered separately from 
the Software Distribution Center (SOC). When binary files are 
ordered, hey will be supplied on the single XXDP medium on which 
they reside Tor that package. For example, if the DECTAPE 
versicn of MPG is ordered, you would get only TCOP DECTAPE # 18. 


me ee ee ee 
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The listing kit owe hee for MPG consists of the “ge listings 
for all Device Routines, this Users’ Manual, and the XXOP Users’ 
mag The SDC Checklist numbers that are applicable et MPG are 
as follows: 


Checklist Description 


ing Kit 
Kit _ 
ing Kit and d Tie 8 Track RAGYAPE @ 3 
i 
21 ind Kit and IMDP Peirack RAGTAPE ® 3 
ZJ197-RY Listing Kit and RXDP Diskette #6 


aA orgy entry for the RPOY was not included in the above list 
si XXDP is not available on that june of medium. The user 
aust “build the system on his own pack f one of the available 

media. In the case of the RPOD for MPG, all that is needed is 
the Listing Kit. 


as 


Since the principal users of MPG will be nognereyr enntes 
personnel, a special language has been developed to Simplif 
rogram definition and — This language consists of Englis 
Tangua ¢ format statements for 
hafacteristics of this language include f 
independence, and easy learning. 


data processing and I/0 functions. 
fexability, machine 


of commands that allow him to contro] MPG’s operations and 
utilize the mj thy functions rye re with MPG. These aang 

ude a ag modification, storage and retrieval of 
ice assignment, etc. 


functions inc 
defined programs, dev 


The combination of the progres language and the user commands 
rovide the foundation for MPG’s usefulness as a diagnostic tool. 
ith ease of use being a major consideration in *s design, 

these components were oriented toward relieving the user of as 

many tedious operations as possible. For example, 1/0 operations 
may be defined at a high level where the user specifies only the 
function to be performed and MPG handles the device at the 
interface level with default values for memory address and byte 
count. The user may still have MPG handle the device interface 
but define a specific memory address and byte count for the I/0 
function. Or, the user may pea the device at the interface 
é 


level himself with complete Ireedom of device usage. 
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2.0 GENERAL INFORMATION 
In addition to the program language, the user_is furnished a set 
Another consideration was the elimination of associated programs 
or libraries that would tend to complicate MPG’s uSage. 
Therefore, MPG contains all routines required to support the user 
and his programs. Even though it performs a compile function, 
does not require additional assembly programs ofr macro 
libraries during its operations. MPG is Completely self 
contained in the stand alone version. In the operating system 
version it will utilize only the components required, such as 1/0 
handlers. 
| 


In keeping with the ease of use pet toosahe all commands and 
program statements are entered to vie the keyboard. For 
instance, the user, after determining the task to be progr canes 
makes 8 series of keyboard entries which consist of brief 
statements that define the task to MPG. Upon ngaptesing these 
entries, the user can then use the MPG commands to execute these 
statements ceregren! with a variety of options without changing 
the statements he entered. 


3.2 


3.3 
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MPG FEATURES 


USER PROGRAMS 


The user is required to specify the tasks and/or data operations 
that are to be performed by his program. These are entered in 
the form of progran language statements which are fetined in 
eee iz 8. refize each statement will be a line number 
which is used for branching and for engtenees modifications. The 
user may enter his own values for the line numbers or enter a 
space and have MPG calculate and yb the next highest line 
number which will have an increment factor of ten. 


MULTIPLE USER PROGRAMS 


MPG will support simultaneous execution of up to sixteen user 
rograms. his xo is useful in troubleshooting 
nteraction problems or for a _. concurrent troubleshootin 

of individual device problems by two or more technicians. Eac 

preerse controls one device and is treated as a separate entity 

MPG. Programs are distinguished by having a number (1, 2, 
etc) assigned to each. The format of various commands utilize 
these numbers and allow the user to perform operations on any 
program without affecting the other programs. 


USER PROGRAM DATA AREAS 


In the course of writing a rrogree. the user may have need of 
pepery locations which will be used as counters, storage areas, 
data input, etc. While MPG allows the user to define specific 
memory addresses if wanted, it also provides the user _with 
predefined areas which are reterenced by symbolic names. These 
areas are of two types with the first being a series of sixteen 
contiguous 1 word lofations that are uniqué_ to each program. 
hese locations, whose names are TMOO thru TM1S, are useful for 
data meaningful anly to that program. The second type of data 
areas is Common to all programs and is useful when passing 
information between programs or for supplying or altering dat 

from the command level. This second type has two formats which 
may be used as the need dictates. The first format is ten 
contiguous 1 word locations with the symbolic names of COMO thru 
COMS.” The second format is a buffer that consists of sizteen 
contiguous 16 byte areas (256 bytes total) with the names of BFOO 
thru BF1S. Any COM or BF areas may be accessed by ‘he user 
pregrons and also altered from the command level with the FILL 
command. 
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MPG Features (Cont’d) 


3.4 170 AREAS 


Since many 1/0 operations will not be dependent upon usage of 
apees the memory locations, MPG provides two types of 1/0 areas 
which have protrrtase syabol ic » ace. For each program there is 
a varisble re read area (RDIO) fol lowed immediate by in net 
by @ variable length un pte hy (WRIQ). When wth athe § 
cetching ¢ each a user # pene ar a the size 
these areas. esel va ues) which are es 


changed to any alue from O or the largest bilousa te 


poner size. O and WRIO are be EI we to each pre ram and even 
though two or mee rograms men 6 4 lerl the sa if mbolic nengs, 
each® di of rfterenc! g di nt erase ) Vaenory. 

othe area, which is _— as FREE, extends from the end of 


MPG to the end of negere. Its size will be determined by the 
size of poset WE. he number and length of user programs. 

Important eapes s of FREE are its use as an area for +i r 1/0 
operations and as a common area where 1/0 data is passed between 
programs. Caution the FREE orcas when oul tials pro cons are 
arbitrarily go area since the data redd by one 
program could destroy another program’s data. 


sizes of RDIO an 10 cones e 
will have a b.. 5. size of 24, 
will ezist at the lowest 12K vordg'8 f “available menor 
{ 12K words are not available, will be at e 
largest area available. 


The high level 1/0 statements utilize the program’s I/0 areas as 
default values. READ and WRITE statements will default to ROIO 
and WRIO, resp pestivera, with byte counts of 256. When the 

area is referenced as the medory location for these commands, a 
byte count must be specified. 


It should be noted that the user is nct spied to use these 
areas and has complete freedom 8 def nies open) tis memory 
addresses and agte counts for his I/0 operations. course, 
this freedom tempered by the necessity of a HE in the 
user’s selection of nener areas. They should not be within MPG 
or other user progrens. tr within his’ program area, thes must be 
within his ROI hin Free 
Memory. 


Note: In the Memor —_ ement version of , ocomt ined 
ceed be 21,359 by 
ee HE o 


and WRIO areas. They may Be anywhere wi 


If the user is doing only read operations or only write 
sper ations and their length qqeaens the size of RDIO but are less 
than the combined size of RO O and WRIO, he ney apecity ROIO as 
the 1/0 ares. Since Wat0 follows n memory and is 
contiguous, the user has in effect o 1/0 ee the size of ROIO 
lus WRIO. Care must be wk oO never rater fore reads, whose 
ength exceeds the size of RDIO plus WRIO o ROIO or reads, 
whose length exceeds the size of to, , into WRIO. If this 
occurs, the program’s source statements and possibly its object 
code will be destroyed. 


JOI 
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MPG Features (Cont’d) 


3.5 OPERATION SWITCHES 


Since there are several functions common to the type of programs 
written with MPG spr Satten of error information, stopping after 
an error, etc), these functions are provided as integral 
components of MPt 
these functions may not be desired. 
regres a set of software switches (bits) that are interrogated 
hroughout execution of the user’s program. These switches are 
preset to default_values but can be modified by the user in three 
different ways. The first two methods are through commands. 
With one format of the OPSW command, the user can change the 
switch settings for a particular progres while the other 
format provides for setting al] resident programs to the same 
value with one command entry. The third method is by statements 
in the user’s program. By aeing the + even: name , the user 
progres can contain statements that reference its OPSW and modify 
he switch values at any time during execution of the progran. 


However, in ser tale situations some or all of 
d herefore, has for each 


As will be seen, certain bits in the OPSW word are not used by 
MPG. I he user wishes, he aay utilize these bits for his own 
urposes. Since each OPSW word i$ modifiable from the command 
evel and the user program can interrogate any bits in it, these 
bits amy be used to control the execution of a program in a 
manner to be determined by the user. 


The switch (bit) meanings of each program’s one word OPSW have 
been defined in accordance with the standard bit useage listed is 


the og | oe Engineering Standards Document # 175-003-009-0 an 
are as Tollows: 


OPERATION SWITCHES 
Preset value is: 100000 
BIT VALUE FUNCTION 


is= 0 Continue program execution on error. 
1 Cease program execution on error. (Preset) 
i4= 0 Go to next device at end of program. 
1 Cycle program on current device. 
13 = 0 Print on error. 
1 Do not print on error. 
le= 0 Not used. 
ll= 0 Not used. 
lo= 0 ptoe when the device list is exhausted. 
1 Cycle the device list. 


KO1 
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ay oe on current device on error. 
@ to next device on error. 
4 is is oe only when 


Perform error checking. 
Do not perform error checking. 


Bo not perform specia sperettees. 
erform special operations as indicated in 
the device routine’s documentation. 


Not used. 


Check for I/0 timeout. 
Do not check for I/O timeout. 


peseaaeneats dis day gozice counts 
based upon the value 3. 
Do not olan device” Bs X, 


Display device counts at the 
ve of each program pass 

splay the counts only after the 
final program pass. 


Clear the device counts when the 
RUN command is issued and after each 
Eredet pass + ry ot — final pass. 
lear the counts onl y when 
the RUN command is iss 


Print the VERT? pepnyonperes detected 
with IFY statement 

Print only the first data soeveeneary 
detected with the VERIFY statemen 


Print ’PROGRAM COMPLETED’ message after 
the final peste of the fothe poogr ee 
Do not print ’ TED’ message. 





| Seve | Sobe.t | peeeg 
| Bags | ESCe 5a | Bees 
{. Se ae ny | Sen enamen 
| fo rxSS | rkym | Relat 
| es ; ante clenmmesniinittion 
S51 ey | es | 58 
| 85 | S82 | 325 
| nen | ae ae | noes 
za; co { ws | e8s 
gi 28 | geo | base 
5 Scanntnenibiannitanice | Le | eee 
i - H i 
s | Be | Be | os 
ee 
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4.0 DESCRIPTION OF OPERATION 


MPG is provided on XXDP media and may be loaded by the XXDP 
Monitor or UPD1/2 programs. However, inherent with MPG is the 
ability to operate on media which is dedicated solely to - In 
this Case, MPG provides its own boot and loading functions. 
Refer to Section 8 for instructions concerning creation of MP 
dedicated media. Also, refer to Section 6 for instructions 
ertaining to the loading of MPG by XXDP or from its own 
pgdisates media and to Section 7 for an example of initiating 


After being loaded, the MPG Stand Alone Executive’s housekeeping 
section will initialize vector locations O through , determine 
the memory size, clear higher memory, and request the date. 
After receiving the date, the Executive will attempt to access 
Memory Management’s MMRO register. If found, a message will be 
issued that asks if Memory Management is to be used. 
reply is Y, <CR>, or <LF>, the name of the MPG file to be loaded 

i -MPG. I was not found or if the reply 
was N, the file name will be set to nm. MPG. e 
console terminal constants are requested followed by the 
0 ; 


Note: The remainder of Section 4 (Description of Operation) 
ertains to the non-Memory Management version of MPG. 
he Memory maneqeqee) version is nearly identical in 

operation excépt for some additional capabilities. 
Refer to Section 9 for information concerning these 
capabilities. 


Once loaded, MPG will assume control] of the processor. 
Housekeeping will be performed followed by the typing of MPG’s 
title line which includes its version number and the addresses of 
the restart points. (The restart point RST1 provides for 
complete clearing of internal MPG flagwords, tables, and user 
programs while RST2 performs the same functions except that any 
user progrens are left intact.) After the title message is 
figpl ue will load the Valid Devices Table, which is file 
TVDAnm.MPG, from the load device and place it in MPG’s program 
space. Next, a Memory Map, which lists the Free Memory 
available, will be displayed. Upon completion of the Memory Ma 
display, APG Lupes its ER message followed by an asteris 
y 


Next, new 
loading 


and is now ready to receive its first command. 


The MPG user comaands provide a variety of services such as 
operation control, user program definition and execution, progras 
modification grseree storage and retrieval, etc. These 
commands, fei re listed in Appendiz A, result in immediate 
action by . After each command is entered, it is checked for 
volidita. and then the task it specifies is performed. Fg! towing 
this, tupes an asterisk and waits for the next command to b 
entered. is continues until the user has entered all] desired 
commands except RUN. At this point, a RUN command or a null 


SR eee eee 
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Description of Operation (Cont’d) 


4.1 


keyboard entry (carriage return only) will cause MPG to ergcees 
to user program execution. When all Jrograns have completed or 
if no programs were available for execution, MPG will return to 
request additional commands. 


ENTERING A PROGRAM 


Upon recognizing the ENTER command, MPG will issue the ?ASGN DEV: 
message which requests an cntry that is either the ph NONE 
or the model number and if applicable, the decimal unit numbers 
(from 1 to 16 unit numbers specified individually and/or as 
strings) of the supported device for which the program is to be 
written. Fol towing this message and reply wo more messages, 
which display the preset sizes of RDIO a fo and request new 
values, are issued. For each message either a null keyboard 
entry, which indicates that the preset values are to be used, or 
a decimal number, which specifies the desired size of each area 
in bytes, may be entered. 


If the pt A. the *ASGN DEV: message was NONE, 8 small dummy 


device routine, which occupies mifimum memory space, will be 
generated followed peceeeens to program statement 
rocessin If a model number was entered, the device routine 


or the aide! specified will be loaded into memory with its 
filename being dis bones on the console terminal. Acting upon 
information contained within the device routine, MPG will issue 
the first of three messages. These messages, each of which 
require a reply, will identify and Shep len the preset values for 
the device’s device register address, interrupt vector address, 
and bus rogeest priority in that order. After each is displayed, 
a read will be issued to the console Keubeard. | ata is 
entered, it will be used to replace the existing date. If a nul 
entry (carriage return or line feed only), the Original data wil 
be left intact. The first two messages process one word of dat 
while the third has the sepepitete of displaying and receivi 

two words (separated by a comma). This feature is required { 
communication devices which require different bus priorities { 
read and write. If the second bus priority word (write’s) is 
gers, salg the first word (read’s or the Snly priority) will be 

isplayed. 


Note: If the reply to the ASGN DEV message is terminated by a 
line feed Cinstead of a carriage return), the subsequent 
messages and replies for ROIO size, b size, device 
register address, interrupt vector address, and bus 
priority will be b passed and results in their preset 
values betas utilized. Also, if the reply to any one of 
the five mesSages just mentioned is terminated by a line 
feed, any remaining messages will be bypassed. 


& 
ng 
or 
or 
i 


When device routine processing is completed, MPG allocates room 
for the RDIO and WRIO areas, issues @ message indicating that it 
is ready to receive program statements and then types a ‘greater 


- - ane cone @ rn rc en ee EES on 
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Description of Operation (Cont'd) 


4.2 


than’ (>) sign, At this time the user er entering these 
statements. (Refer to the pangs programs included with each 
evice Routine soartestes n Appendiz DO.) Since all progres 
statements must have a line number as their first component, this 
must be the first — for the statement. The user may enter a 
1 to 4 character decimal number followed My a tab (or 8 ce) and 
will use that as the statement’s line number. Or, he may 
enter a space and MPG will generate a new line number which has 
the value of the current line number + 10. After the line number 
1s defined (by either method), the program statement is entered 
on the same line and followed y carriage return. As each 
entry is received, it is validated and then stored in memory in a 
condensed format. This continues without any al actions until 
the END and DONE statements have been processed. Following the 
will scan the stored program statements, make further 
validity checks, and then compile a section of machine code based 
upon the functions indicated by these statements. 


Nezt, MPG issues the “PGMS COMPILED / MEM REFORMATTED” geesege 
and then types an asterik to indicate that it is ready for the 
next command. If the user desires, he may enter the MM command 
and have siagtegee on the console leretac! 8 geners map, which is 
a series of messages listing the oper stes and en ee addresses 
for each user program and for Free M nets. Included for each 
rogram is its name if it was fetched or the default name of 
if it hes been entered without 2s name aeons specified. 
Also included is the model code of the device assigned to the 
program. Whether the memory ae is displayed or not, the user 
May now execute the ee just defined, list the progran 
statements and the octal machine code poner ster for the progran, 
define another program in a different program slot, or initiate 
any other MPG command. 


When the ENTER command or the FETCH command is issued, MPG makes 
no checks as to whether a program already exists for that slot. 
If one does exist, it will be destroyed by the new program. 


EXECUTION OF A PROGRAM 


Once the user has defined one or more prosrens. he may initiate 
their execution through use of the command. The format of 
this command provides for activating a single eroqree or multiple 
programs with each program being started at its beginning or, 
optionally, at s specific statement on the first unit. {ter 
entering ai} desired commands, the entry of the RUN command wil] 
initiate program execution. 


Note: If desiring to continue execution of a previously otopesd 
program without initiating any other programs, the 
issuing of the Continue command (CONT p) followed by 
either a null hagpeors entry or the RUN command without 
program number will initiate program execution. 


C02 
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"e reco aising any of these entries, MPG will begin pe re 
the program slots 1 ge a a loop technique. Startin 
with slot @ 1, will chetk each Slot and ascertain if 
program is present. If not, it proceeds to the next slot. If a 
rogram is present, an internal oregees eequece will be tested 
o determine if the program has beén specified for execution and 
if it has, whether it has been stopped 4 the user or by an error 
occurrence. If neither of the —_ conditions are present and if 
the program is not waiting for an 1/0 termination, then contro] 
will bé@ transferred to the eee s object code at its current 
address. The program will retain control + magn i until one 
of the following Conditions causes it to return contro] to MPG: 


- The Device Routine has initiated a high level I/0 command 
and is waiting for device termination. 


nn ee ee ee er ae + ee ee cee +e 
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- The Device Routine attempted a high level I/70 command but 
the contro] unit was already busy. 


- The Device Routine detected an error during a high level 170 
operation. 


- The user program contains a Control Release (LETGO) 
statement which is being performed. 


- The user program has completed. 


Upon receiving control again, MPG performs the aoqespery 
functions for suspending that program and then proceeds to tes 

the next program slot. Alter proce —_ the last program slot, 
the scanning will resume at program slot 8 1. I! all prograns 
are wo) ties for 1/0 termination, MPG will continue lo ping 
through the program slots looking for a program that is ready t 

continue execution. When one of the I/70 functions terminates, 
the next time that its associated peagres slot is scanned, 
program execution wil] be resumed. When a device is already busy 
or when a control release (LETGO) is issued, gre ram execution 
will be resumed on the next program slot scan. This allows all 
other programs at least one chance at execution before these 
programs régain control. 


Program slot scanning continues until all programs have either 
terminated or been Stopped by the user or because of errors. If 
multiple units were specified for the proeres device, the 
program will be run on each unit before terminating. When 
precessin a program’s termination, MPG will issue a ™ e 
, message for that pegsran: Upon determining that al 
progres slots are inactive, will return to thé command 
section and request new commands. 


An automatic feature provided by MPG at program termination is 
the display of the applicable statistic counts accumulated by the 
the program’s device routine. These counts, which include the 
commands issued, bytes read and/or wrilten, and errors, are 


| 
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displayed at the end of each ee pass or when continuing to 
the next unit upon detecting af error on the current unit. The 
automatic display of these counts and when they will be wy tH o- 
are controlled by bits in the progran’s word. Another 
method to djspla hese counts at ' time is with the REPORT 
command. he tount Sperone wil iepiay the same information 
that is automatically displayed at the e f a program pass. 


As mentioned previously, when a program returns contro] to MPG 
its) execution will be sus coded, This consists of storing the 
contents of ees through and the in a reserved area 
within the pfogram’s space. Also stored in this space are an 
words left on the stack by the user peers. When determines 
that a progres is to be given control again, it ual reload th 
stack with afy saved words and restore registers through 
before resuming execution of the program. It should be noted 
that the maziaum number of words that can be saved off of the 
stack is thirty. If a user pceeree returns contro] with more 
or in words on the stack, it will” be aborted with an error 
condition. 


Whenever a program is specified for exzecuticn with the RUN 
command or when it is repeated for the next device in the device 
list, all storage areas for the registers, stack words, temporary 
work areas ( through TM1S), the device routine words (BLK, 

» SECT, etc.), and the applicable device routine counters are 
cleared to zeros or set to their preset values before ster ting 
the program. Clearing of the device routine counters can b 
controlled by the user with bit 2 in the program’s OPSW. The 
user may 8 ecif that these counts are to be reset only when the 
RUN command is issued. 


INTERRUPTING USER PROGRAMS 


While user programs are a ae the user may enter commands by 
first potatos MPG’s attention with an CONTROL ’C’ entry from the 
mogeeer - Upon pecogetere this entry, which will be honored 
on if user programs aré executing, MPG will suspend execution 
of the user programs and abort any outstanding read or write 
issued by user programs to the console terminal. As an added 
fedogg ing aid, MPG will display the values of the an & 
the Vime of boterrust and whether a user progres (identified b 
its number) or MPG had control. Folioutas his message, 
types its ENTER CMND message and the asterisk which is preceded 
by an I to indicate that MPG is at the saterrues command level. 
Al this time the user may enter any command with the exception of 
those that could change the position in memory of the currently 
executing progr ene or the current device number for a user 
program. The Commands which will not be honored are: 


aC eS a Tr TE ee ae ee ee 
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ENTER FM 
T aS (directed t ) 
mooiFY SATE? (Remory Mgant ohlyd 
TE UBMAP = (Memory Mgant only) 


After all desired commands have been entered (changing of OPSW 
values, stopping a progran, etc) and the RUN command or the nul] 
entry made, execution of the user programs will be resumed at 
theit point of interruption. 


If the user wishes to use one of the restricted commands, he must 
issue the STOP command for all executin programs and then let 
program execution resume. Return to the Command ones section 
will occur immediately if a program did not have control at the 
time of interruption or if one did, when it releases control. 


One command has been tachuded poostticolls for use when 
interrupting user programs. The KILL command provides the user 
with the ability to either abort a program that has hung in a 


loop which does not allow return to or to force an immediate 
termination of a program. Any eregren stopped with the KILL 
command can be restarted only with the RUN command. 


USER PROGRAM MODIFICATIONS 


After a user program has been entered, the need may arise for 
replacing or deleting existing statements or for the insertion of 
new ones. Rather than require the user to re-enter his entire 
regres with updates opplicd, MPG contains a source correction 
acility which provides the functions necessary for this purpose. 


Once the user has defined a program, he any alter its statements 
through use of the MODIFY command. When this command, which can 
specify only one preeres, is entered, sets itself to accept 
program statements from the keyboard. Each statement entered 
must contain a line number (statements have a 1 to 4 digit line 
number as their first component) and it is this that identifies 
the type of update required. A line number followed by the word 
DELETE will cause the deletion of the qotehing numbered statement 
in the program. If a program statement is entered and its line 
number matches an existing statement, the original statement will 
be replaced with the new statement. If there is not a matchin 
line number, the new statement will be inserted in correc 
numerical sequence. After all corrections have been entered, the 
user issues the DONE command which causes MPG to re-compile the 
meotstes program. Following this, MPG returns to request another 
command. 


If the user desires a Nisting of all statements in his updated 
program, he may issue the DISPLAY command which will Step | oy all 
statements and optionally, the octal machine code generated by 
the compiler, cn the console terminal or alternate print device. 
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Another form of progres modification is accomplished with the 
command. ith this command the user can change the unit 
numbers assigned to an existing ig te or even meee the device 
constants for the prgeren. If the user wishes to change only the 
device constants (dévice register address, be véctor 
address, or bus gy all that is needed is the ASSIGN 
command issued with the original model and unit numbers. The 
existing values for the addresses and pring will be displayed 
and then changes, if any, can be entered. 
| 
| 


4.5 SAVING AND FETCHING OF USER PROGRAMS 


Since some user og aay be rather large and under various 
conditions may need to be a a number of times, 
provides the a ae to save and then later retrieve the user 
progress statements on either the sypten load device or poner 
ope This capability is accomplished through use of the ASSIGN, 
: 


and CH commands. 


The ASSIGN command has a format which allows the user to alter 
the devices used by the /SAVE and TCH commands. Normally, the 
system load device is the preset device for these commands. 
efer to section S.2 for more details. 


The /SAVE command identifies the een entered regres whose 
statements are to be saved and the name that they will be saved 
under. After receiving this information, MPG will extract each 
rogram statement stired in the condensed format, expand it to 
ull format, and then write it to the SAVE device in the correct 
blocked format. This continues until all statements have been 
processed. MPG then returns for the next command entry. 


The /FETCH command identifies the stored program by name and the 
program slot into which it will be loaded. Processing of this 
command is very similar to the ENTER command described in section 
3.1. The one major difference is that the FETCH device is 
searched for the named program and that the progres statements 
are read from it instead of the keyboard. Other functions such 
as device assignment, statement validation, and program 
compilation are performed in the same manner. 


Additional commands are provided to aid the user in the saving 

and fetching of his programs. The /LIST command provides a 

directory of the pregrans resident on the FETCH device while the 

/DELETE “command allows the user to delete programs from the SAVE 

gevice. The /ZERO command will initialize a new medium on the 
evice. 


= a ee 


am a a ee 


a i ee 


HO2 


M.P.G. Page 20 


|5.0 DEVICE SUPPORT INFORMATION 


| 5.1 DEVICES REQUIRED FOR MPG 


| 
j 
{ 
j 
| 
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The devices required by the stand alone version of MPG are 
necessary for its loading and communication with the user. Any 
other devices required would be the units to be tested. The 
following are the minimum requirements: 


- One PDP-11 series central processor 
(LSI-11 through 11/70) with a 
minimum of 16K words of memory. 


- Any one of the following load media 
devices: 


~ TUS6 DECtape transport and 
associated TC1l control unit. 


- RKOS DECPACK disk drive and 
associated RK11 control unit. 


- TU1O MAGTAPE transport and 
associated TM11 control] unit. 


- TUI6 MAGTAPE transport and 
associated TMO2 control unit. 


- RXO1 Floppy Disk drive and 
associated RX11 control unit. 


- RPOY Disk drive and associated 
RH11 control unit. 


- One console terminal (LA3O, LA3E 
T33, or VTOS) and its associated 
control unit. 


- Device to be tested 


5.2 OPTIONAL DEVICES FOR MPG 


The devices listed in section S.1 are required for MPG and its 
Executive. There are, however, additional devices which may 
opciones ly be used for certain MPG functions. The support for 
these devices is completely independent of the high level 1/0 
device routines. 


consol 
LV11 

al 
1 I/ 


The LIST device, which is initially assigned to the 
terminal, can be assigned to a prister (LP11, LS11, or 
through use of the ASSIGN comand. When this option is used, 


‘ 
print information generated by the user programs, high leve 0 


a | ae ee ee ce ee te eS Eo Ee om. 


i EE 


M.P.G. Page 2l 


Device Support Information (Cont’d) 


5.3 


device routines, ram source displays (DISPLAY command), and 
the mereesery disp a (/LIST command) will be directed to the 
printer, If desiring to resume use of he conagle terminal as 
he L device, the assignment of KYBO, » or as the 
LIST device will effect this change. 


The SAVE and FETCH devices, which are yy assigned to the 
MPG load device, may be redirected to other devices through use 
of the ASSIGN command. Either or both the SAVE and the FETCH 
device may be assigned to another unit on the load Covige. This 
is accomplished by entering the load fovee by mode nenper 
followed by the deSired unit number with the IGN command. The 
FETCH device can be assigned to the paper tape reader (PCI1 or 
Aves Pe ge : , Bw x. vies to the ao “ee punch ag oF It 
shou e note 4 en using paper tape e use of certain 

commands (/LIST 7OELETE,  /BOOT : a/ ) will result in 
errors boing reported. Also, even though not used, the one to 
siz character program name used in the /SAVE and /FETCH commands 
must still be supplied when using paper tape. After assigning an 
alternate SAVE or FETCH device, Arey We to the load device 
can be gosenptiohes by espigaing either COAD, , or its model 
name and unit number to the desired device. 


MPG DEVICE USAGE DETAILS 


Sections 5.1 and 5.2 list the devices that can be used by MPG for 
its own functions. This section provides the details doout G 
usage and also general information about the devices. 


Console Terminal 


The console terminal driver is located in the Executive and 
operates in an interrupt driven mode. The preset values for its 
device constants are: 


Read: evice Register Address = 177560 
nterrupt Vector Address = 60 
Interrupt Proc. Status Word = 200 (BR 4) 
Write: Device Register Address = 177564 


nterrupt Vector Address = 64 
nterrupt Proc. Status Word = 200 (BR 4) 


During its one time housekeeping, the Executive samples the 
console terminal by testing the write status reaieter, If not 
there or if is not set, the Executive will halt. (This is 
the only halt in the Executive that is not preceded by an error 
message.) When stopping at this halt, register RO contains an 
address which points at the word containing the read device 
register address. The five words te? lewiag this word are in the 
same order as listed above. At this time, the user may ones 
any or all of the siz words and thereby direct MPG to an operable 
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console terminal. After the changes have been made rope eseion 
1 a ey will cause MPG to repeat the console terminal test wit 


por ine execution, the MPG console terminal driver recognizes 
certain control characters and acts upon them as follows: 


RUBOUT The last character entered on the current read will 
be deleted. The character or characters deleted are 
typed and enclosed in backslash (\) characters. If 
é entered characters have already been deleted, a 
carriage return/line feed will be typed. 


CONTROL/U Types the “fU" characters, deletes all data entered 
on the current read, and then mgoee a CRALF. 
Effectively re-initializes the current read. 


CONTROL/C This entry is honored only if user programs are 
ry oy & When processed, it causes any read or 
write to the console terminal to be aborted, the 
m. characters to be typed, and entry into MPG’s 
User Interrupt Mode to be made. 


CONTROL/O Causes all further writes to the console terminal to 

be pagoronnes. This action remains in effect until 
MPG returns to request a new command or until an 
error is detected by MPG components other than the 
Device Routines. If used while user programs are 
running, al] messages issued to the consolé terminal 
are suppressed and will remain enpgroseee until all 
user rograms have either een stopped or 
terminated. If desiring be rhgsuae typing Goring 
user program execution, a /C entfy will rese 
the intefnal software flag used for suppressing 
typeouts. During command entry there is no way to 
resume typing until the current command completes. 


CONTROL/S This entry instructs MPG to suspend al] further 
writes to the console terminal after the current one 
completes. The console terminal is put in a 
simulated busy condition and remains so until an 
character, other than a CONTROL/ is entered on tha 
megpeare. This character is discarded and typing 
will resume at the point of interruption with no 
loss of data. This feature can be used while user 

pregrans are running and will have the same effect 

on their output. 


eee 


For console terminal writes pas tere ite is provided for up to 
twenty bytes. There is no bufferring or read data. 
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PRINTER 


Any of three printers (LP11, LS11, or LVI1) can optionally be 
pestgeee as the MPG LIST device and will be used for certain 
display functions. The driver for the printer is interrupt 
driven and operates with the following preset constants: 


Device Register Address = 177514 
Interrupt Vector Address = 
Bus Request Priority = 4 


The above constants can be changed after using the ASSIGN command 
to assign the printer as the LIST device. The current values 
will be displayed after each ASSIGN command and can be changed if 
desired. 

PAPER TAPE AND LOAD MEDIA HANDLERS 

The handlers contained in MPG perform the services required for 


regres and file maintenance. This includes the loa ing of MPG 
iles, the paving and  feteding of user programs, directory 
ur 


displays, etc. rently, MPG supports seven handlers which are 
for the following devices: 

PC11/PR11 paper Tape 

RK11 DE ee isk 

TCil DEC ape 

TMG2 MAGT 

TM11 MAGTAPE 

RX11 Floppy Disk 

RPO4 Dis 


Due to size requirements, the MPG Executive will contain the 
Paper Tape handler and only one of the other handlers which will 
be its load media. This results js iz versions of the grecutie 
with each supper tie a different o medium. ww to Section 
for further details concernin he various Executives and 
instructions for generating MPG load media. 


These handlers are modified versions of the XXDP Program 
handlers. Tass are not interrupt driven and require only device 
register addresses for their operation. Due to their Original 

implementation, the device regteter addresses are fixed and 
cannot be changed. the following are the addresses for each 


device: 
177550 = PC11/PR11 Paper Tape Reader 
177554 = PC11 Paper Tape Punch 
177400 = RK11 DE geek is 
177340 = TC11 DEC ape 
172440 = TMO2 MAGT 
172520 = TM11 MAGTAPE 


a 


me 
oO 
rm 
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177170 = RX11 Floppy Disk 

176700 = RPOY Dis 

| 

| 5.4 DEVICES SUPPORTED FOR USER PROGRAMS 
The title of this section is somewhat eee tes Devices 
considered as sup peer ie? under MPG are those for mie a level 
1/0 functions (Read, Write, Seek, etc.) are available. owever, 
due to the $losebtlitg and power of the low level bonguege, | a 
knowledgeable user may program t the device interface level 
therefore, in a _ lesser vaanee, ae the word, has support for 
practically any POP-11 device. even though’ the Gev ce you 

sh rer rHise aay not be k “the coliow RL list, do 7 lose 

heart. You will — ave to work a little than if the 

| high level I/70 functions were available for the "desired device. 

Even so, it is still easier to program the device interface with 

' 

| 

| 

} 


instead of comp posing he pecsscery instructions in octal 
g them to memory 


machine language and writi 
Supported Devices: 
- DH11 16 Line Programmable Asynchronous Multiplezor 
- DJ11 16 Line Asynchronous Multiplexer 
- DLI1 Single Line Interface 
- DQ11 NPR Synchronous Line Control 
- DULL Single Line Synchronous Interface 
- LPLIALSIIALV11 Printers 
- PC1I/PR11 Paper Tape 
- RKOB Disk 
~ RK11 Cartridge Disk 
~ RPO2/RPO3 Disks 
~ RPOY/RPOS/RPOB Disks 
~ RSO3/RSO4 Disks 
- TC11 DEC Tape 
~ TM11 Magnetic Tape 
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5.5 DEVICE SUPPORT SUMMARY TABLE 


The following table reflects the type of support provided by MPG 
for each device. Note that te 7 peviees are supported | for MPG 
functions t+ not for nigh level 179 operations. hese devices 
and the other devices that are listed but which do not have high 
level I70 supp port indicated, all have small basic device routines 
which contain the s yabol ic’ names of the device registers. Also, 
devices that are tuppor ted as SAVE and FETCH devices, other than 
paper tape, are applicable only if they are the MPG MPG load device. 


DEVICE vid 
of " FETCH SAVE 
vice re VICE DEVICE DEVICE 
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MPG LOADING INSTRUCTIONS 


As stated posters™, MPG is supplied on XXDP 
ability to operate from media which is dedicat 


media but has the 
ed to it, Section 

6.1 contains the information concerning loading of MPG through 
n to 


0 
o while sections 6.2 through 6.6 pertai MPG dedicated 
media. 


The boot procedures contained in sections 6.2 through 6.8 may be 
used to load either XXDP or dedicated MPG media. gy 
the boot peseserrs listed in the XXDP User’s Manual may also be 
used for loading both types of media. 


Upon completing any of the following load procedures, MPG will 
erform its housekeeping functions, request the date, issue its 
intialization messages, and then type an asterisk to signify its 
readiness for the first user command. 


LOADING VIA XXDP 


After loading the XXDP Monitor by using the instructions in 
either é *s User’s Manual or in sections 6.2 through 6.8 
the Monitor will type its title line and seege information an 
then wait for a keyboard entry. At this point the user may 
gicectly load MPG by typing one of the following command 
followed by a carriage return: 


R TCMPG (TC11 version) 


R RKMPG (RK11 version) 
R TMMPG (TM1I1/TULO version) 
R THMPG (TMO2/TULE version) 
R RXMPG (RX11 version) 
R RBMPG (RPOY version) 


This entry results in the specified version of MPG being loaded 
and contro] being transferred directly to it. ) 


The difference in the versions listed above consists of the type 
of device that will be used as the primary SAVE/FETCH device. 
Paper Tape is the secondary device in al] versions. 


An alternate method of loading MPG is through XXDP’s UPD! or 
UPG2 programs. Instead of loading MPG directly as just 
described, goter either ‘ee or “R as the cealy to th 
Monitor. he solgeted program will be loaded and wil 
request the date. After making this reply, an asterisk is typed 
and the program waits for a command entry. At this point the 
user must enter two commands in order to initiate ; he 
first command specifies that a program is to be loaded, the 
device from which it will be loaded, and the program's name. 
The valid program names are those listed previously but with 
-BIN extensions. The second command initiates execution of the 
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loaded r) An e of loading and initiating the RK11 
version 1 AP “irom an XxDe RKi1 1 pack ‘ a8 tol lows: Ss 
LORD _DKO:RKMPG.BIN 
START 


The only difference in MPG’s operation wi ¥ loaded under XXDP i 
that after MPG requests the date, it will request the unit 
number of the drive that is to be ese ned as the initial 
device. When loadin dedicated version of 
wre. it is 1 s set to the Jee device. In the prior econe’s 
a reply of ill set the TCH assignment to the same RKII 
unit as which “PC happened to be loaded fron. 


It should be noted that when MPG assumes control, it will 

destroy the XXDP Monitor and an rogram in core. In order 

to resume XXDP operation, the load medium must be rebooted or 
"3 /BOOT command used. 

DEDICATED MEDIA LOADING INSTRUCTIONS 

The ama sections contain the information and ety ee 

neseasoary for ihe} loading cf Each bosties will ape! y to 

specific ype of MPG input medium. As additional ore 

supported, their instructions will be added. 

TC11 DECTAPE INPUT 

The following are the initial steps for loading from DECtape: 

1. Mount the MPG tape on unit O. 


2. Set the REMOTE/OFF/LOCAL switch to 
REMOTE. 


3. If hardware S bootsiren Lgcters BM792-YB, 
ARI are present, go 
to tn | Py b. Bathe 


4. If not present, go to section 6.3.2. 


6.3.1 TC1l HARDWARE BOOTSTRAP 


1. Set the Switch Register to: 


773100 for the BM7S2-YB or, 
773120 for the MR11-D6 or, 
773030 for the “YA or, 
773070 for the -YB. 


2. Press the LOAD ADDR switch. 
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3. If the BM7S2-YB, set the Switch Register 
to (word count register for 
DECtape). 


4. Press the START switch. 


| 6.3.2 TCL SOFTWARE BOOTSTRAP 


1. Set the Switch Register to O10000 and 
press the LOAD switch. 


2. Set the Switch Register to the first of 
its potioning values and prose the 
osi , 


t swite Continue epositing 
until all values are entered. 
10000= it5an MOV STCWC RO 
eat MOV 8-256. , TCWC 
10010= 1 MOV #4002, TCCM 
4002 
5710 A: TST TCCM 
100376 BPL a 
10020= 12710 MOV #3, TCCM 
10S710 B: TSTB TCCM 
100376 BPL 
10030= wok MOV 8S, TCCM 
105710 C: TSTB TCCM 
100376 BPL . 
1004%0= 5007 CLR PC 
3. Set the Switch Register to OQO10000 and 
press the LOAD switch. 


4. Press the START switch. 


&.4 RK11 DECPACK DISK INPUT 
The following are the initial steps for loading from disk: 
1) Mount the MPG DECpack on drive O. 


2) Load the drive, write lock it, and then 
wait until the drive is ready. 


2) If hardware bootstrap loaders ®8M792-YB, 
MR11-DB, or BM873-YR/YB are present, go 
to section 6.4.1. 
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4) If not present, go to section 6.4.2. 


1) Set the Switch Register to: 
| eeNtt tor the PRdicDe or,’ 
r the BRE7UYA 6 or, 
Mee wl the BNS73-YB. 

2) Press the LORD ADR switch. 


3) If the BN7S2-YB, set the Switch Register 
to 777408. 
4) Press the START switch. 


6.4.2 RK11 SOFTWARE BOOTSTRAP 


1) Set the Switch Register to O10000 and 
press the LOAD switch. 


2) Set the Switch Register to the first of 
the following values and po the 


| 6.4.1 RKL1 HARDWARE BOOTSTRAP 


DEPosit switch. Continue epositing 

until all values are entered: 

10000= 12700 MOV #RKWC , RO 
177406 
12710 MOV 8-256. , RKWC 
177400 

10010= eal MOV #S,RKCS 
105710 A: TSTB RKCS 
1 BPL A 

10020= 


3) Set the Switch Register to O10090 and 
press the LOAD switch. 


4) Press the START switch. 


' 
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| 6.5 TM11 MAGTAPE INPUT 


The following are the initial steps for loading from magtape: 


1) Mount the MPG tape on drive 0 


\t ready by rewinding it 
placing ft ONLINE.) 


and make 
to BOT and 


are present, go to section 


2) If har duarg bootstrap loaders MR11-DB8 or 


3) If not, go to section 6.5.2. 


6.5.1 TM11 HARDWARE BOOTSTRAP 


1) Set the Switch Register to: 
773136 for the MR11-DB or, 
7730S0 for the BMB73-YA or, 
773110 for the 8M873-YB. 

2) Press the LOAD ADR switch. 


3) Press the START switch. 


6.5.2 TM11 SOFTWARE BOOTSTRAP 


1) Set the Switch Register to O10000 and 


press the LOAD switch. 


2) Set the Switch Register to the first of 


the following values and 
DEPosit switch. Continue 
until all values are entered: 


10000= 12700 A: MOV 
172524 


10 DEC 
1 MOV 
10010= 11 

105710 8B: TSTB 

BPL 

$710 TST 

10020= 100767 BMI 
12710 MOV 
105710 C: TSTB 

10030= 100376 BPL 
$710 TST 

00 D: BMI 


ress the 
epositing 


SMTBRC , RO 


SEBD 11, NTC 


MTC 

B 

ae 
#60003, MTC 
MTC 

C 

MTC 

") 

PC 
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MPG Loading Instructions (Cont'd) 


6.6 


6.6.1 


6.6.2 


3) Set the Switch Register to O10000 and 
press the LOAD switch. 


4) Press the START switch. 


TMO2 MAGTAPE INPUT 
The following are the initial steps for loading from magtape: 
1) Mount the MPG tape on drive O and make 

it mene a rewinding it to BOT and 

placing it LINE. 


2) If hardware bootstrap loader BM873-YB 1s 
present, go to section 6.6.1. 


3) If not, go to section 6.6.2. 


TMG2 HARDWARE BOOTSTRAP 

1) Set the Switch Register to 773150. 
2) Press the LOAD ADR switch. 

3) Press the START switch. 


TMO2 SOFTWARE BOOTSTRAP 


1) Set the Switch Register to O10000 and 
press the LOAD switch. 


2) Set the Switch Register to the first of 
the pos lowiog values and press the 
DEPosit switch. Continue 


epositing 
until all values are entered: 
10000= 12700 MOV #MTCS1,R0 
172440 
12760 MOV #1300, MTTC 
1300 
10010= 3e 
12760 MOV 8-1, MTFC 
: 6 
10020= iy MOV #31,MTCS1 
sab A: TST MTDS 
10030= 100375 BPL ms 
12760 MOV #-256. ,MTWC 


ee ee ee ee 
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NPG Loading Instructions (Cont’d) 


6.7 


6.7.1 


6.7.2 


3) 


4) 


10040= 12746 MOV #71, MTCS1 
105710 8: TSTB MTCS1 
100S0= eesti Ai MTCS1 
o 108099 C: BMI c 
S007 CLR PC 


Set the Switch Register to OQ10000 and 
press the LOAD switch. 


Press the START switch. 


RX11 FLOPPY DISK INPUT 
poe Sedtautng are the initial steps for loading from the Floppy 
isk: 


1) 
2) 
3) 


4) 


Insert the MPG Diskette in drive 0. 
Insure that the drive is ready. 


If hardware bootstrap loader BM792-YL is 
present, go to section 6.7.1. 


If not present, go to section 6.7.2. 


RX11 HARDWARE BOOTSTRAP 


1) 
2) 
3) 


Set the Switch Register to 173400. 


Press the LOAD ADR switch. 
Press the START switch. 


RX11 SOFTWARE BOOTSTRAP 


1) 


2) 


Set the Switch Register to O10000 and 
press the LOAD switch. 


Set the Switch Register to the first of 
th following values and press the 
DEPosit switch. Continue epositing 
until all values are entered: 


G03 
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| MPG Loading Instructions (Cont’d) 


10000= $000 CLR RO 


12701 MOV @RXCS,R1 
177170 
105 A: TSTB RXCS 
10010= 1 Q # 
oaks MOV #3,RXCS 
oc} B: TST RXCS 
10020= l Q B 
100406 BMI ) 
10$711 TSTB RXCS 
100003 BPL 
10030= ann MOVB RXDB, (RO)+ 
| 770 BR B 
5007 C: CLR PC 
10040= 0 D: HALT 
776 BR D 
3) Set the Switch Register to O10000 and 
press the LOAD switch. 
4) Press the START switch. 


6.8 RPOY DISK INPUT 


The 
1) 
2) 


3) 


4) 


following are the initial steps for loading from disk: 


Mount the MPG pack on drive O. 


Load the drive, write lock it, and then 
wait until the drive is ready. 


If hardware bootstrap loader BM873-YB is 
present go to section 6.8.1. 


If not present, go to section 6.8.2. 


6.8.1 RPOY HARDWARE BOOTSTRAP 


1) 
2) 
3) 


Set the Switch Register to 773320. 
Press the LOAD ADR switch. 
Press the START switch. 


6.8.2 RPOY SOFTWARE BOOTSTRAP 


1) 


Set the Switch Register to Ol10000 and 
press the LOAD switch. 


' 
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2) 


3) 


4) 
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Set the Switch eH po - ~ first of 


the followin —_ ress the 
DEPosit switch. oo ng Gepositing 
until all values are entered: 
10000= ' MOV SRPCS1,RO 
1 MY MOV #23,RPCS1 
10010= ae CLR RPDOC 
om CLR RPDA 
10020= 12760 MOV #-256. , RPWC 
177400 
12746 MOV #71,RPCS1 
105710 A: TSTB RPCS1 
100376 BPL e 
5007 CLR PC 


Set the Switch Register to O10000 and 
press the LOAD switch. 


Press the START switch. 


a re etn a a ee ny 
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7.0 INITIATING MPG 


When the Executive and MPG are pitially loaded they will 
display information pertinent to MPG’s operdtion. The 
request information from the user and allow him to spe | if 
is to utilize certain optional hardware features if they are 
available on the ogsten. The teh leutas exeaple lists the 
es ages that can dccur for ite this itjalize tee process. 
ncluded after each message is a Grief explanation of the message 
and its ~ be oy responses, if any. Note that any response aust 
be terminated by either a Carriage Return <CR) or a Line Feed 
‘(LF> and that default values are supported when either of these 
are the _ | made. For this example, the loading of MPG’s 
RK11 Executive on an 11/70 system has been chosen and all user 
responses have been underlined. Also, even ey they may be 
the same as the default values, responses are shown for all 
messages requiring thea. 


DTE1A-n RKMPG - RK11 EXECUTIVE FOR MPG 


This is the Executive’s title message and lists its MAINDEC 
number, revision number, and type of load device. This 
message will be different for each version of the Executive. 


DATE (DD-MMM-YY) 
*#10-FEB-76 <CR> 


The current date in standard DEC format is requested by this 
message. A valid date must be entered as the response. 


This is an optional message and will occur only if the 
Executive has been loaded either an XXDP Monitor or XXDP’s 

1/2 programs. Since another program has loaded the 
Executive, it hog no way of determin ng the unit number of 
the load device. hereford it requests that the unit number 
be entered. This number will always be retained for the LOAD 
device but the SAVE and FETCH devices may be resssignes later 
with the SIGN command. The default unit number for this 
response is 0. This message will not occur if the Executive 
is the program that is booted. In this case, the Executive 
retrieves the current unit number from the device registers 
and stores it as the unit number for all three devices. 


JO3 


y will also 
i MPG 
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Initiating MPG (Cont'd) 


USE MEM MGMNT (Y/N) 7 Y <CR> 


This meesege will occur only if the Executive has detected 

the presefice of the Nendry Management feature. The rep] 

entered will determine which version of the MPG program is to 

be loaded. If Memory Management is not present or if N is 

entered, the geq-fenery Monegenes) version of MPG (DTMGAn) 
y 


ill be aded. ent of Y or a default entry will 
result in DIMMAn being loaded’ oe 


CONS TERMINAL CONSTANTS: 


This is a header message which prececes a series of four 
messages that allow modificat on of the preset values rer 
constants used with the console terminal. If a  <LF> 
terminator was entered on the reply to any of the three 
preceding messages, this message and the following four 
msagoges will not be issued and their default values will be 
used. 


‘FILL AFTER: Ole / Ole <CR> 


Requests the octal value for the byte after which fill 
characters are to be transmitted. The default character is a 
Line Feed (O12). A <LF> terminator on any one of these four 
messages will cause the Executive to Bypass the remaining 
messages. 


°FILL WITH: O00 7 O <CR> 


Requests the octal value of the character to be issued when 
transmitting fill characters. The default character is a 
null (octal OOO byte). 


‘FILL COUNT: O02 / 2 <CR> 


Requests an octal count for the number of fill characters 
that are to be transmitted. Defaults to two characters. 


— oe ee - 
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Initiating MPG (Cont'd) 


*CONVERT LOWER CASE TO UPPER (Y/N) 7 Y <CR> 


to upper case. This would be applicable if, for example, the 
console terminal is an LAS. If the reply is N, the data 
will not be converted and the user will have to use the Shift 
key when making al] MPG entries. Default value is Y 


At this point the Executive will load the soerenrenss version of 
MPG and turn control over to it. The rema ping messages listed 
are issued by the MPG program. For a <CR> Gr a <LF> may be 
used to terminate any responses entered. However, a <LF? 
terminator will not cause bypassing of any subsequent messages. 
Also, default values are supported for all responses. 


DTMMA-n M.P.G. RST1: xxxzzz; RST: xxzzxrz 


This is MPG’s title message and lists its MAINDEC number and 
revision number. Also included are the octal addresses of 
the two restart poiats available within MPG. Refer to 


Section 4.0 for details concerning the two restart points. 


MPG BASE ADDRESS = xxz2z22 


The starting memory address of the MPG program, which 
immediately follows the Executive in memory, is isplayed in 
this message. 


USE UNIBUS MAP (Y/N) / Y <CR> 


This message will occur only if the Memory Management version 
of is being executed and if it has detected the presence 
of the Unibus me feature. The reponse to this message, 
which has a default value of Y, will determine if MPG is to 
utilize the Unibus Map. 


?USE 22 BIT ADRS (Y/N) 7 Y <CR> 


This message will occur only if the Memory Management version 
of MPG is b ing executed and if it has determined that the 
processor has ee bit addressing capabilities. The Y response 
or the default response will instruct MPG to use ee bi 


This message asks the user if he wishes the Executive to 

automaticall neers console ere data from lower case 

I 

addressing. Otherwise, it will use 18 bit addressing. | 
| 
| 


nm a a ee ee 
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Initiating MPG (Cont'd) 





* MEM MAP # 


END OF MEM = xrzxxzr2rz 


The above messages are produced by the MM (Memor ~~ 
command which is performed as the last step 
initialization. The bine tien and ending addresses of the 
FREE memory area and the address of its mid point (MIDL) are 
displayed. The third message displays the end of actual 
memory. This third pestess does not occur in the non-Memor 
Management version. For that version, the end address o 
is the end of actual memory. 


#lst command 


The asterisk indicates that MPG has pongesses initialization 


ABS ADRS: FREE MEM = xxxzzxrzxz TO xrrzzzrzzz (MIDL) = rzzzzzz2) 
and is now ready to receive its first command. 


———— 


8.0 GENERATING MPG MEDIA 


MPG supports operation when loaded from various media as 
specified in section 6. This oyaert includes saving and 
fetching of user programs on the load device or other units on 
its control unit or on paper we Also included is the initial 
loading of MPG and the loading of the Device Routines for user 
programs. 


The files required by MPG and any user programs are stored in 
absolute format which is compatible with the file structure 
utilized by the XXDP ene ram. Since this compatibility exists 
and since XXDP prov ded tiie maintenance servi cass is used 
to create and maintain media. This use of eh gnsesyenets 
reduces the size of MPG by not re as ag additional commands an 

routines for functions used exclus vele n MPG media maintenance. 
It should be noted that the user still has adequate maintenance 
a ett for his programs through use of the MPG slash (/) 
commands. 


MPG and its Device Routines reside on the XXDP/MPG media in 
ohsalute format with .MPG extensions while the Executives have 
-BIN extensions. User programs are also stored in the same 
format but with .USR extensions. This allows the user to easily 
distinguish between his stored programs and the files provided as 
components of MPG. It also eliminates the possibility of 
duplicate file names. 


The format of the filenames assigned to MPG components adhere to 

multimedia standards with the exception of the Executives. 
Since they are the files specified in LOAD statements, their 
names more readily indicate their differences and the fact that 
they are part of - Also, they do not contain revision numbers 
so that the same name may be used regardless of revision. 


allocated and are identified by the first two letters D These 

two letters indicate that MPG if a Diagnostic Tool. As a general 

rule, the MAINDEC numbers match the component’s filenames gucep! 

for the XXDP conventions of dropping the D and the adding of the 

MCO level. Once again, the only exceptions are the Executives. 

The Sot lowing are the filenames and NDEC numbers for the 
W 


For MPG components, a new series of MAINDEC numbers have been 
we 


Executives here n is the revision number and m is the MCO 
level): 

Filename MAINDEC 8 Version 

TCMPG. BIN 11-DTEOA-n TC11 DECtape Executive 

abe te fd 8 mit petpess precutive 

" n agte zecutive 

THPELBIN Ii-DIESA-n «THOS ogtabe Executive 

ee Bin 11-DTEYA-n RX11 F lope Disk Executive 

REMPC. 11-DTESA-n RPOM Disk Executive 


NO3 
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Generating MPG Media (Cont'd) 


The actual 


one of the Executives, have the following {1 


numbers: 
Filename MAINDEC 8 





Thee. 185 11-DTNGA-n 


11-DTMMA-n 


The following are the filenames 


ee eee ee ee 
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programs, which can operate i nm loaded ott 


ames and MA 


ee (Non monary Management) 
(Memory Management) 


and MAINDEC numbers for the 


Device Routines currently provided with MPG: 


Filename MAINDEC 8 
TOHAna. MPG 11-DTDHA-n 
TOJAaa. MPG 11-DTDJA-n 
TOLAna. MPG ieee 
TOQRaa. MPG 11-DTDOA-n 
TDURaa. MPG 11-DTDUA-n 
TLPAna. ine 
THSAna. ll THSA=n 
TPCAna. MPG 11-DTPCA-n 
TRKAna. MPG 11-DTRKA-n 
TRPAaa. MPG 11-DTRPA-nv 
TRSAna. MPG 11-DTRSA-n 
TR3Anea. MPG ll res 
TREAna. MPG ll fi 
TTCAna. MPG 11-DTTCA-n 
TTMAae. MPG ll r) 


Device(s) 


Gee Po Pas Pe pes fh be fe Be Pe 
PR Bo Ps Pan Pe Bm be b> Gs 


: 


RSSSCL SELLE 


The following sections contain the instructions to generate the 


various MPG media using the 


program of 


These examples 


assume DECtape input but can be used as a basis for generating 


from any medium. Note that 


transfers the MPG Executives 


the last command in each example 


files. This is not reall 


pocpocera for MPG operation but is shown in case the user wishe 
e 


to have 


se files on the cutput mediun. 


= me rr ee ne ee i | i ee gS 
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Generating MPG Media (Cont'd) 


8.1 


8.3 


TC1l DECTAPE MEDIA 


Assuming the MPG input medium is on drive O and the output will 
be created on drive 1, issue the following UPD2 commands: 


COMMAND FUNCTION 

ZERO OT1: Initializes output medium 

OAD DTO: TCMPG.BIN oads Cet tape oe into core 
Tl: uts bootable Exec on tape 

ILE OT1:<DTO:#.MPG Puts all MPG files on tape 

FILE OT1:<OTO: ??MPG.BIN Puts all MPG Exec’s on tape 


RK11 DECPACK MEDIA 


Assuming the MPG input medium is DECtape drive and that the 
output i. DECpack drive O, issue the following commands: 


COMMAND FUNCTION 





ZERO pen: Initializes output DECpack disk 
LOAD :RKMPG. BIN Loads disk Exec into core 

SAVM : Puts bootable Exec on disk 
FILE DKO:<DTO:#.MPG Puts all MPG files on disk 
FILE DKO:<DTO:??MPG.BIN Puts all MPG Exec’s on disk 


TM11 MAGTAPE MEDIA 
Assuming the MPG input medium is DECtape drive O and that the 


output is MAGTAPE drive O (can be seven level or nine level), 
issue the following UPO2 commands: 


COMMAND FUNCTION 

ZERO MTO: Initializes output MAGTAPE 

L oT : hee BiN oads TMO2 MAGT: zec into core 
: THPG. uts bootable zec on tape 

LOAD DTO: THMPG.BIN Loads TM11 MAGT: rec into core 

SAVE_MTO: TMMPG. SAV Puts TM11 Exec on tape 

FILEF MTO:<DTO:#.MPG Puts al] MPG files on tape 

FILEF MTO:<DTO:7?MPG.BIN Puts all MPG Exec’s on tape 


eee + 


i 


| Generating MPG Media 


(Cont’d) 


' 8.4 TMO2 MAGTAPE MEDIA 


| 8.5 


8.6 


8.7 


The UPD2 commands age’ a enerate p,, THOE version of A igh re 
identical to those or d r_ the Try eae Th onl 
difference is that instead of apeti lying hou 

used. The media produced for the TMi! or the THO2 nay be 
loaded on ot thes phe aa or the he bootstra der 


determines device tapi’ and then loads either Rho d first 
or the th seanhaes on 


RX11 FLOPPY DISK MEDIA 


mogenene Asi MPG jopst acting is DEC ope drive and that the 
outpsl ft s Floppy k drive O, issue the filYeusng commands: 
COMMAND FUNCTION 


pg pe ogtpat. Diskette 


ZERO DXO: 
LOAD ay RXMPG.BIN Reeds F oppy Oi Disk Exec into core 
a 


Puts vootatt Exec on Diskette 
FILE :(DTO: #. MPG Puts all files on Diskette 
FILE DXO:<DTO: ??MPG. BIN Puts all NPC Exec’s on Diskette 
RPOY DISK MEDIA 
Roquniag the MPG input medium is DECtape drive O and that the 
output is RPOY drive O, issue the following UPD2 commands: 
COMMAND FUNCTION 





Initializes output disk 
Loads disk Exec into core 
Puts bootable Exec on disk 


uts a files on disk 
FILE DB0:<DTO:??MPG.BIN Puts al] MPG Exec’s on disk 
USER PROGRAMS 
The UPD2 program can also be used to transfer stored user 
pregr ons between different MPG media. When doing this, the LOAD 


d DUMP commands ma 
FILE or FILEF dev:#. 
user programs. 


be used for individual prog. ane while ¢ 
SR commands may be used for transferring a 


a eo ee eee seni 


mm ne ee we 2 a - + + oe 


i 
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9.0 MEMORY MANAGEMENT VERSION OF MPG 


3.1 


The Memo nord Management version of MPG, which has a filename of 

TMMAna. requires 18K words for ly deed it and occupies 16K words 
or less after f housekeep pica. Not only doe have all of the 
features described for the non-Menory Repapeneal version, but it 
also has some additional features unique to its application and 
some restrictions. 


ADDITIONAL COMMANDS AND FEATURES 


The following are the more visable differences between the two 
versions of 


- During its a peop ae the Memory Management {erates 
MPG will determine i pe o Uaioe 5 Map an a at U"nidreteing 
are available on the _— en. either or are 
will ask if Aen are to be used. At this tine the user may 
specify any combination of usage for these features. 


- When copertodite or recenies 5 user program, the user is gives 
the opportunity immediately after entering the command to 
specify the starting address’ (a jgned to a 3c word 7 ag 

his’ pro coe 3 me ory area. an address is entered ‘ 
progr ram will begin oF bat Pe oles and will remain at that 
address Suatil deleted or moved to a new address 
Sl use of the SHIFT command. If an address is not 
entered, MPG til copige a memory address in the same manner 
as the "non-Memory agement Version. Note that fixed 
address programs gil be? identified by an F in their line of 
the Memory Flap display. 


- Two commands have been added and an existing one expanded 
for this version. Their full descriptions and optional 
formats are listed in Appendix A.4. 


The SHIFT command allows the user to move his program to a 
different area of memory and also change its program slot. 


The UBMAP command can be used to change the Unibus Map 
registers assigned to a user program. 


The MM command with a program number specified, will list 
the following detailed information about the program: 


-- The standard information line which consists ,of the 


absolute program area addresses, the program's name, 
and the device assigned to the program. 


-- The values that will be loaded into the User Mode PAR 
and POR registers when the program is running. 


-- The absolute addresses for RDIO and WRIO. 


E04 
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Memory Management Version (Cont'd) 


-- The absolute addresses of FREE, MIDL, and the end of 
memory. 


If the Unibus Map is pe used by the program, the 
following will also be displayed: 


-- The Unibus addresses for RDIO and WRIO. 


-- The numbers of the Unibus at registers, which are 
assigned to the program, and their contents. 


-- The Unibus addresses for FREE and MIDL. 
-- FREE’s Unibus Map register numbers and their contents. 


- The “DISPLAY p CODE” command will display the absolute 
addresses and the virtual addresses of the Jrogran’s object 
code. 


- The RDM, WRM, BOC, ADD, and SUB commands wil! ay up to 
22 bits for their addresses and/or operands. The CBD and 
COB commands still support only 16 bits. 


9.2 TRAP ROUTINE 


A common trap catcher has been added for traps that occur at 

vectors 4, 10, 114, 250, and non MPG traps at 34. If the tra 

occurred in a user progres while it is running, an attempt wil 
A 


be made te kill progres and fgatious running any remainin 
prose ane. f the trap occurred in ahalt will ofcur afte 
he display. Depressing the "CONTINUE? switch after the halt 
will cause a pe o the restart (RST2) point. When the trap 
catcher is entered, it will display the following information: 
- The vector address of the trap. 


- The contents of registers O thru 7 and the PSW at the time 
of the trap. 


- The contents of the Memory Management registers (MMRO-MMR3). 
- The contents cf the failing mode’s PAR and POR registers. 
~ Whether a user’s interrupt was being processed. 


- Whether the trap occurred within MPG or a user program. If 
a user program, its number will be displayed. 


ae ton el 


a te rr ee Ee ee. 
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9.3 RESTRICTIONS 


The following restrictions apply only to the Memory Management 
version: 
' 
' 


- The size of each pre ram’s area (device routine + RDIO + 
WRIO + source + ob) 


- The size of FREE will be a mazimum of 12K words. 


eft code) cannot exceed 12K words. 


- The RESET instruction is a no-no and is not supported. 


- The VECTOR instruction is not supported. Therefore, the 
user will not be able to write and include an interrupt 
service routine in his program. MPG’s generation of 
absolute addresses for the user prosren' © object code 
prohibits this feature in a virtual envifonment. 

- Extreme care must be taken if the user is using absolute 
octal addresses in his program. Octal addresses, which 
reference the device registers or other registers in the 1/0 

age, are supported. However, if outside of these areas, 
raps may occur if the area they reference is not mapped. 


- The mazimum size of an absolute octal address entered on 
user preeree statements is 16 bits. This includes high 


level 1/0 statements. 


9.4 MEMORY MANAGEMENT IMPLEMENTATION DETAILS 


MPG utilizes the Memory Management feature in a manner that is 
compatible with all POP-11 *s. This results in the Data Space 
and Supervisor Mode capabilities not being used if present. 


| 
' 

MPG operates in Kernel] Mode and then transfers the mode to User 

Mode when it gives contro] to a user program. Prior to givin 

control, the User Mode vegioters are aaepes to tha 

user’s areas. When the user pees am gives contro] back, Kernel 

Mode will be entered again and will remain in that mode until 

it gives contro] back to the seme program or to another program. 

Interrupts generated by user progres device routines are serviced 

in Kernel Mode. Also, certain groviges functions utilized by 

the device routines and program statements (PRINT for example) 

will result in Kernel] Mode being entered for a very brief perio 

to initiate the function. 

To aid in the underetending of MPG’s operation, the following 

tables list the usage of the PAR/POR registers for each mode: 


ween ee ee a a  e_ -  ee eo oe 
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Memory Management Version (Cont'd) 


9.5 


Kernel 
PAR/POR Usage 
0-3 uae mapped to MPG’s program space. 
4-6 General work and also used during 
jaterrupt servicing. 
7 1/0 Page 
User 
PAR/POR Usage 
a-8 Yeer se rogram area 
3-5 ¢ FREE 190 area 
6 chered code area within MPG 
7 Page 


The values loaded into the User Mode PAR/POR registers are 
initialized only when the RUN command is issued or when starting 
the next pass of | program. When the user program is running 
and gives up control, the apreees beatense of these registers are 
stored and then reloaded when ains contro] again. This 
allows the user to set up his =. ra ues in certain registers and 
operate without being concerned that MPG will change them back. 
However, certain registers =, never be changed or the resuits 
will be 4 yy a Se, our hands off of PAR/PDR 
registers 2, 6, and since Pt y are holy. If you must use 
a BaR/POR efits, use one or more of the 3, 4, and S group. These 
are norma for FREE, but if the program never references FREE 
or MIDL, they can be used for other purposes. 


If the user has a program which must know whether it is runnin 
under Memory Management or not, the per heute two statements ma 
be used to OB pees ne this fact. seated statement wil 
perform the GOTO if Memory Mh is being He. 


LOAD TMOO WITH OPSW 
IF TMOO = 2 GOTO nnnn 


UNIBUS MAP IMPLEMENTATION DETAILS 


When a device routine is loaded for a user’s regres, a flag is 
interrogated to determine if tne sevice requ r¢ the Unibus Shap. 
it does and if the Map is being used will determine how 
none conti quess registers are nesded d ({ to 3) and then ask for a 
first pogie er number. The valid register numbers are in the 
range decimal 7 thru 30. If three registers are needed, the 
hi ent valid Lid register og number would be 28. If a number is not 
entered, select the lowest available registers and then 
display nek number of the first register chosen. If the user 


SS SS = 
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later wishes to use different registers with his program, he may 
issue the UBMAP command and change the registers. 


The following table lists the utilization of the Unibus Map 
registers: 


Registers Usage 
0-1 Lower area of aT Le space. 
2 Never used within . Available as 
: work pegister. 
3-5 he FREE 1/0 area. 
Shared code area within MPG. 
7- 30 Assignable to user programs. 


obding and whenever is restarted.” Registers 3 thru 5 and 
ru are re-initialized whenever the command is issued 

and when memory’s format is changed. The latter occurs after a 

program has been Entered, Fetched, Deleted, Modified, or Shifted. 


Telding O, 1, and 6 are initialized by MPG upon its pritic 


TT TS A a ee en 


I04 


ee 
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APPENDIX A 
USER COMMANDS 


A.1 MPG COMMAND SUMMARY 


For eaten tee descriptions of the following commands, refer to 


RUN 6 AT In 
STOP p 
an & 
ad] TO p 
adl,u,u,u TO 9 
adl,u TO LIST (also SAVE and FETCH) 
DELETE p 
REPORT p 
REPORT p COUNTS (also STATUS) 
OPSW coco 
» 10 bbbb on Nenat seta) 
emor mnt on 
- (Memor Mgmnt anid) 
LL Bran WITH #aaa...a 


FILL BFnan WITH oo00,000c,etc 
FILL BFan WITH Saaa...a 
FILL BUF WITH PATn 

ain COMn WITH oooo 

FILL COM WITH #aaa...a 


MM 
MM p,p,p (Memory Mgmnt only) 


ROM bbbb,ccce 
WRM bbbb,oo00 
BOC bbbb,cccc 
ADD 0000,9000 
SUB 0090, 0000 
CBD o000 

COB dddd 


| 
! 


User 


A.2 


M.P.G. 
Commands (Cont’d) 


MPG COMMAND ENTRY INFORMATION 


a following is information concerning the details and options for 
entry of MPG commands: 


All poametiy entries are terminated by a carriage return or a line 
ee 


All command names (ASSIGN,DISPLAY,ENTER,RUN,/LIST,etc) ma 
entered either in full or in tbat shortened form which is Whee 
first two characters (AS,DI,EN, 


Separator cottrts., fat. TO, WITH 96) and certain’ keywords 

(BUF , BF an, COM T'SAVE, FETCH, CODE,STATUS, COUNTS) mag be 
entered in salle - “their 3 shortened tare which gopsisis.o! of only 
their first character (A,T,W,A) and (B,8n,C,Cn,L, 


For example, “FILL BFO2 WITH 1,2,3” could be entered as 
“FI B2 W 1,2,3". 


Device mode] numbers and the keywords NONE, KYBD, KBOO, and LOAD 
must be entered as four characters. 


In the command eomners and definitions, commas are shown as 
operand separator characters; spaces may be used instead. 


Leading and trailing commas and/or spaces will be ignored. 


Multiple commas and/or spaces will be treated as a single comma 
or space. 


Leadin neres in progres Oe nuahere, octal data, decimal data ans’ 
number’, line numb {fer numbers do not need to be 
entered. If they are they “ull “be ignored, regardless of the 
number of them entered. 


Several commands accept aut ipte program numbers and in some 
cases, intermized formats ese commands are: 


RUN DELETE KILL 
STOP REPORT MM (Memory Mgmnt only) 
CONT DISPLAY 


The following commands require a program number entry but will 
accept only one number: 


ENTER MODIFY SHIFT (Memory Mgmnt only) 
ASSIGN /SAVE UBMAP (Memory Mgmnt only) 
OPSup /FETCH 


All commands that perform I/0 operations on either the SAVE 
Sovise, or the FETCH device are prefixed with the slash (/) 
character. 


am ne i ee + ee 
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A.3 MPG COMMAND OPERAND DEFINITIONS 


Pp 
line number 
In 


md] 


(Cont’d) 


The decimal eo number in the range of 1 to 16 
that is assigned to a user program in MPG. 


The one to four digit decimal line number 
prefized to each statement in a user program. 


The four character model number of a device that 
will be used within This may be the control 
a hel model number or the unit’s model 
number. 


The one or two digit decimal unit number in the 
rover 0 u 15 for a specific unit ona 
multiple unit control electronics. 


A word of data expressed in one to siz octal 
digits. 


oor or more ASCII characters used to define ASCII 
ata. 

One to siz alpha-numeric characters. Used to 
identify saved user programs. 

An absolute memory address specified in one to siz 
octal digits. May be one to eight digits (22 
bits) on the Memory Management version. 

A decimal number in the range of O thru 65,535. 
One digit number in the range of O thru 9. 


tue digit decima) number in the range of OO thru 
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A.4 MPG COMMANDS - DETAILED DESCRIPTIONS 


CLASS 1 -- PROGRAM ASSOCIATED COMMANDS 


ENTER p 
ENTER p AS name 


RUN p 
RUN p AT line number 


RUN ore at Ia, » 
RUN 


STOP p 
STOP p,p.p 


| CONT p 
' CONT Ps PoP 


| 
‘KILL p 
‘KILL p,p,p 


Indicates that the user wishes to enter 
program statements that will be 
identified as program number p (1-16). 
If a progres n s not supplied, the 
default name of will be assigned 
to the progran. 


Note: Only one program number will be 
processed with this command. 


This command initiates progres execution 
at the first statement of the program 
indicated by p. A second format, T 
line number, provides for starting a 
ecoaren at a specific statement which is 
dentified by its line number. A single 
command may be used to start one or more 
programs with any miz of formats. If no 
program number is supplied, MPG will 
scan the program slots and start 
execution of any user programs that are 
active. For example, a CONT command has 
just been issued for a program. 


Used to stop the execution of one or 
more preg. eee. Each program will remain 
intact and may be resumed from the point 
it was stopped. 


Used to resume execution of one or more 
programs that have been stopped by a 
user command or have ceased execution 
due to the occurrence of an error. 
Actual program execution does not resume 
until a command is entered or a null 
keyboard entry is made. 


This command is used primiarily to force 
termination of user programs that are 
hung in an internal loop and therefore 
do not release control to MPG which 
would allow the STOP command to cease 
their execution. KILL can also be used 
to stop a program that is not ina oep. 
However, any progres stopped with the 
KILL command will be stopped janediotely 
and can be restarted only with the RU 
command. 


MO4 






DELETE §. psp 


ASSIGN md] TO p 


ASSIGN mdl,u,u TO B 
ASSIGN mdl,u,u-u TO p 
ASSIGN mdl,u TO SAVE 
ASSIGN mdl’u TO FETCH 
ASSIGN NONE TO LIST 
| REPORT p 


| REPORT pp STATUS, p 


| REPORT p OUNTS 


NO4 
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Instructs MPG to delete the indicated 
programs and deallocate the memory they 
occupied. 


Allows the user to change the unit 
numbers echdnge to . exis ring progres 

nd/or . change 1 see wise. s Constant 

f a single “uni evice, no uni 
number is needed. If a multiple unit 
device, such as eagnestie tape, oi ther a 
1 es unit number series of single 
unit numbers, and/or a string of 
consecutive unit numbers (mazimum of 
sizteen) may be specified. When usin 
this command to change unit ae al 
line feed terminator on the reply 
cause MPG to bypass requesting "neu 
device constants. 


The NONE entry is used to oe ~~ 
current devite for the LI 

CH devices. Other ney words whi 
be used for deassign aint ae cave 
KBOO for LIST and 
FETCH. It should be oe That i the 
LIST, SAVE, and FETCH operands egtry of 
only their “first character tL 
acceptable. 


rorese the display of all device 
isters, error information, and 
stitistics for the program or pro ay 
specified. This command a *pp plies on 
{ ose programs that utilize bigh idvel 
1/0 language statement and devicg 
routines which provide reports 
variation of this command allows the 
user to disple specific reper’ 
information. The TS. operand will 
display onl ioe sponte Rite the STATUS 
operand wil sepie ly the device 
registers. 11° neither of hese operands 
ar specified, beth reports w é 
displayed. Entry of only the first 
letter for TS and STATUS is 
acceptable. 





ee ee ee eee 
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Used to set the MPG Sper etion Switches 
to the values indicated by oo00 which is 
an octal word (Refer to Section 3.5) 

If the progrem number } is not entered, 
the Operation Switches Tor all currently 
resident programs will be set to the 


indicated value. When is entered, 
only that cores switches will be 
aod{ tied. hen enterin 8 program 


number, only one may be ehtered. 


This command is supported cola ge the 
Memory Management version of . The 
first format is used to move the 
specified prewes to 8 new area in 
~— whose $ yom address is_defined 
by the octal addréss bbbb. The nove 
will be performed as long as the area is 
not already ——— and there is enough 
room. The second format allows the user 
to shenge his program’s number and 
consequentially its ios loop slot. 
If this command is directed at rogras 
whose memory address is controlled by 

the program may be relocated in 
memory in order to retain the pagnenties 

r) 


aenees addressing _common 
controlled programe, The third format 
allows the user to return 8 program 


which is located at a fized address tha 
was defined earlier, to MPG control of 
its address. 


This command is supported only on the 
Memory Management version of - With 
this command the user oon change the 
Unides Map registers sesig ed to prograa 

. The first action pefformed is to 
not the registers narsently 
assigned to the progr cn. Next, it wil 
ask for new register assignments in a 
manner which is identical to the way it 
requested the register assignments when 
the pregren was Entered Or Fetched. 
After the assignments are received, all 
programs will be recompiled. 


BOS 


OO ooo 


User 


FILL 


a rn ns es + me + eee eee 
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CLASS 2 -- DATA PROCESSING COMMANDS 
' FILL BFnn WITH oooc,c0000,etc Allows the user to load one of the 


BFnn WITH #aaa...aa 
“an 0000, 0000, ete 


en aM H pagee- 


sizteen common data buffers with either 
_—_ —_ or ox date. The value 
é u 1S and _fhae) iq? 
by By is to filled. 

{ less than 16 bytes of octa ‘ serds or 
tte is Specified, the aonenee 
fete X... ] be prope gated throughout the 
byiee re then bytes are 
ten d, the data will be truncated 
after the first 16 bytes. In the third 
format, where nis not specified, all 
gizteen buffers will be reaied as one 
a hy buffer. Octal or ASCII data 

will Be Grapes etetibne (oth its entire 
length with no restricti (other than 
the size of t byte keyboard read-in 
area) on the ceobah f bytes entered. 


The prefiz codes # and & for the ASCII 
data formats provide the user with 
control over the inclusion of sarrtone 
return and line feed characters at the 
end of his data. The # format will 
eutenst ical ty include the CR/LF while 
the 8 format will result i only the 
data entered by the ser. When 
grepesstiog data, the *ORVLE will be 
reated the same as user data. 


The PATn format will fill the halo 
buffer with the bit pattern specified b 

Ta. The various patterns availabla 
are listed in Appendiz C.3. For this 
boraes n can have a value of O- 9, A, 
or 


nS ee 


! 
i 
| 
} 
| 
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Fy WITH #aa..3 
FILL COMn WITH @aa 
FILL COM WITH PATn 
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This is an alternate format of the FILL 
command and allows the user to access 
the tena ae work areas which are two 
bytes each. The number n represents the 
work area number and may be in the range 
of O thru 9. The data ay be enter tt 
a pattern or in either oftal or 
format. If a number is not supplied, 
COMO through COMS wil] b¢ treated af a 
twenty by @ area with data propagation 
taking place if less than twenty bytes 
of data is entered. 


The codes #, &, and PATn are treated the 
same. as in the FILL nn command. 
However, when 4 ae a specific COM 
word (COMn) and using the #aa format, 
the resulting contents Of the COMn wore 
will be a CRALF, regardless of the 
number of data characters entered. 


CLASS 3 -- USER PROGRAM SOURCE MAINTENANCE COMMANDS 


MODIFY » 

DISPLAY p 

DISPLAY p CODE 
DISPLAY p,p CODE,p 
/SAVE p 

/SAVE p AS name 


/FETCH name AS p 


Instructs MPG to interpret the 
subsequent keyboard entries as program 
statements which are to be applied as 
corrections to the program specified by 

The program p must already exis 
efore using this command. 


Causes the dis Jay of the pores i. 
statements on the print device. The 
second format causes tha display of 
program statements and the octal machine 
code generated for each statement. 


Instructs MPG to write the program 
statements of program p to the current 

device. They will be saved under 
the one to siz character 1.0. code 
furnished by name. If a name is not 
specified, the statements will be saved 
under the name peeignes to the ere ran 
in aener Program p will still be 
retained in memory. 


Used to reed progr enc peotousis saved 

by MPG. he fame en ry furniShes the 
-D. of the saved pr ar onthe 
current FETCH device while p indicates 
ne progres slot into which it will be 
oaded. 


a = ee ES eR ae 


ae a ee + + 


re ee ee ee. or ee oe 


cm ee ee ee a ee ere 
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/DELETE name 
‘DELETE name, name, name 
ALIST 


eT ALL 
T FAST 
a ST ALL, FAST 


| /ZERO 


/BOOT 


EQS 
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This command is used to delete user 
progrens stored on the SAY gevics. One 
ore names may be suppli 


The directory of the FETCH device may be 

listed through use of rs command. 

the kepeere is not TT erly 
or 


the sbved user programs wi be | 

If ALL is entere including 

those. sregeires by MPG mail be listed. 
‘7. entered, sale ape Hi Jenanes 

af a; g ill be listed. and 


T are ladopeotens of each other. The 
information prequase by this coma a 
met be displayed on the current LIS 

device (leith the console terminal or 
the printer). 


Use of this A ey will initialize the 


Sireciors ¢ device. It is 
useful when poaentes 6 alternate prograa 
library media. Extreme care aust be 


taken when using this command. f 
directed at the load devies, it will 
destroy the data on that devic It is 
for this reason that a ee message 


which eo a re ly, displaye 
before portocstag * function. 
his message displays the” device’ : 


mode] and unit avabers and req pire 8 
pes reply before performing the Zero 
unction. 


Causes MPG to perform a simulated 

bootstrap function on the current FETCH 

device. The first data block read by a 
normal booterres will a read by 

into obras starting at location zero 

ch to thie zero after the 

his destroys the 


with a bra 
read completes. 
memory resident 


CLASS 4 -- SERVICE COMMANDS 


Display the diaite of the menery 
locations occupied by ea each user progy oe 
and the addresses of Free Memory. (MM 
stands for Memory Map) 


an ee + a + ee ae - 


Use 


NM 


8 


& 


8 


One ee + me 0 ee re ee + eee 
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MM p 


PyPsP 


bbbb 
bbbb,ccee 


bbbb, coco 
bbbb,oo00,c000,etc 
bbbb,ccce 


0000,0000,etc 
8600,0005 
0000 


ee + ee, te eee 
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This command is supper ies onda on the 
Memory Management version of - With 
this command the user may en more 
detailed information about a single or 
pories g! mer ergereas- Refer t 
ection 93.1 for Getdils as to wha 
information is displayed. 


This command formats memory by 
slininatiog any pogees menory spac 
etween contfolled user pro ams an 
hen recompiling all use programs. 
This situation shouldn’t occur but under 
pons antgne error or abort conditions it 
might. 


Dispien the contents of the word at the 
octal memory address specified by bbbb. 
If the optional second address is 
supplied, displa up to and including 
the second addres’. 


Write the single or string of octal 
words (0000) a at the octal 
memory address specified by bbbb. 


Used to calculate the branch offset 
value between two even memory addresses. 
The first address (bbbb) is the et 
address of a branch offset type o 

branch instruction with the second 
address (cccc) being the destination 
address of the branch. The answer 
produced must be visually checked for an 
out of range condition by the user. 


Add the two or more octal numbers and 
display their result. 


Subtract the first octal number from the 
second and display the result. 


Convert the octal binary number — to 
decimal and display the det inal result. 


Convert the decimal number to binary and 
display it in octal. 


‘ 
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WRITE, REWIND, SEEK 


atc., see ur steup listed under appropriate device name, in ppendiz 


For specific peripheral instructions such as READ 
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B.2 MPG PROGRAM LANGUAGE - VALID PARAMETERS 


| VARIABLES (v) - Any of the following are equally interchangeable: 
Symbols - Any predefined symbolic name listed in 
Appendix C or Appendiz D. Includes those for 


temporary storage, common storage and device 
register names. 


Octal Numbers - Any octal number from O thru 177777. 

Decimal Numbers - Any number preceded by a ‘D’ will be 
considered a decimal number. The acceptable 
range is from: OO thru 53S. 

SIT NUMBERS (n) - Any decimal number from O thru 1S. 


LINE NUMBERS (In) - Any decimal number from O thru 9999. 


| 
| User Program Language (Cont'd) 





| LOAD {variable? WITH [variable] 


INCR [variable] 


INCR [variable] BY [variable] 


DECR [variable] 
DECR [variable] BY [variable] 


MOVE [variable] TO [variable] 


ae - SS 


I0S 
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B.3 PROGRAM LANGUAGE DETAILED DESCRIPTION 


Load the value of the aqcene 
variable into the — address 
specified by the first 


Increment the contents of the 
eenery Y word poppaion te 3 et b 

rst veriab amoun 
specified by the Hi. ty Increment 
by 1 if nas second variable is not 
specifie 


Decrement the contents of the 
thet! word location indicated b 
the f Ae erties by “~ amoun 
specified by the second. Decrement 
b if the second variable is not 
shecified. 


The MOVE instruction with no 
parameters implies an indirect 
move. The number of bytes to be 
moved is contained in location NBR. 
Location SRC contains the gterting 
address of the data, while locatio 

T points to where it is to be 
stored. 


Move one word from the mqnery 
location indicated b the firs 
variable to the fosetina indicated 


by the second. 


MOVE [variable] AT [variable] TO (variable) 


ADD [variable] TO [variable] 


Same as basic MOVE exce 
variable specifies th 
bytes to be moved. 


pt the first 
@ number of 


Add one word located at the “first 
location indicated by the sire 
variable to the word residing 

the location indicated by the 
second. Geplece the second with 
the resu 


ADD [variable] AT [variable] TO [variable] 


Same as basic ADD except the first 
variable apeg ities the number of 
bytes to be adde 


SUB [variable] FROM [variable] 


JOS 
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Subtract one word located at the 
memory location gee 4 by the 
first ore il r+ rl rd 
residin he nos toes ed 
by the Second. Replace the second 
with the result. 


SUB [variable] AT [variable] FROM [variable] 


NEGATE [variable] 


User Program Language (Cont'd) 
| SET [variable] BIT [n] - [nJ&[n] 
' 
| 


Same as basic SUB except the first 
variable specifies the number of 
bytes to be subtracted. 


Two's roo soy 1 the contents of 
the memo location referenced by 
variable. 


Set the bit identi tied by th 
number fn in foca ion spécifie 
by variable. 


Bit combinations (AND,8) or bit 
groups (THRU,-) can also be set. 


CLEAR (variable) BIT (n} THRU [nJ AND [a] 


Reset the bit identified by the 
number nin the location specified 
by variable. 


Bit combinations (AND,&) or bit 
groups (THRU,-) can also be reset. 


IF [variable] BIT [n] SET GO TO Cline number] 
| CLEAR 


If the bit identified by the number 
n in the location specified by 
variable meets the condition calle 
os (Set or Clear) then perform a 
oqree branch to the statement 
Gnd cated by line number. 


| IF (variable) BIT [n] “y [nJ&{n] THRU iol ee [line number] 


AND 


Bit snc, S3" (AND,8) or bit 
proves can be identified 


ee + + ee ee 


——— 
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IF [variable] : (variable) GOTO [line number) 


—_—_—— Se 


If the relationshi (=,> ete), 
between the ay s of memor 
specified by the variables, i 
true, perform a poogren branch to 
the statement ” tified by line 
nsign r 


number. ed anch 
instructions will be used. 

NOTE- There is one difference 
between this instruction and all 
others. If the second variable is 
a decimal or octal number, it is 


used as a value, not as an address. 
If itisa symbolic name (tag), it 
is used as an address that contains 
the value to be compared. 


IF [variable] AT [variable] = {varieble) GO TO [line number] 


i 
| 
| 


GOTO [line number] 


| LINK [line number] 


_ RETURN 
PRINT #[ text-texrt-tert] 


' 


PRINT al text-tert-tert] 


Same as preceeding IF operation 
except that the first variable 
specifies the number of bytes to be 
gemgered. Note that either GOTO or 
GO TO is acceptable, and only a 
compare for = or <> is valid. 

Causes an unconditional rogram 
branch to the statement indicated 
by line number. Either GOTO or 

TO are valid. 


Used as a jump to subroutine to a 
subroutine beginning atthe 
statement indicated by line number. 


Used as a return from a subroutine. 


When this statement is encountered, 
rint the text message on the 
isplay device assigned to this 

ew Follow the vast with a 
arfiage Return and Line Feed. 


Same as PRINT #, except that the 
text is printed without a carriage 
return and line feed following. 
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PRINT [variable] IN BINARY 
OCTAL 


RST 
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Convert one word of data located in 

aeners at the address specified by 
le to the format requeste 

it on the assigned 

displeg device. First character 

only (B,0,D,A) is acceptable. 


PRINT [variable] AT [variable] IN BINARY 
OCTAL 


FILL [variable] WITH RANDOM 
ASCII 


(variable) 
PATn 


ROTATE [variable] 


i 


“ROTATE {variable} AT (variable) 


VECTOR [variable] TO [line number) 


| 

| FILL [variable] AT [variable] WITH RANDOM 
| ASCII 
| 

! 

| 


DECIMAL 
ASCIT 


The first variable specifies the 
number of oy ies to be printed 
(starting at the location specified 
by the second variable). A decimal 
or octal number is valid. 


Fill the area of — starting 
with the location specified by the 
first variable with 256 bytes of 
random data, the ASCII character 
set, the bit combination specified 
by the second variable, or the 
pragt tes pattern (see Appendix 


(variable) 
PAThn 


Specify the number of bytes to be 
filled by the first variable. 


Rotate the number of bles 
specified by variable, in this 
program’s write buffer (WRIO), one 
place to the right. 


Rotate the number of bytes 
epost ied by the first variable 
starting at the location specified 
by the second variable, one place 
to the right. 


Store the address of the line 
number in the location epost fies by 
the variable. his location 

normally an interrupt vector 
address. (Note: Not supported on 
tbs ,flenory Management version of 


LOS 
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VERIFY [variable] WITH [variable] seapers two bytes at the address 


ecified by the first wor igbie, 
. th two p bites at the ress 
specified by the second. + a any 
pair in octal ajeng with the byte 
number if they do not compare. 


VERIFY [variable] AT [variable] WITH (variable) 


PAUSE 


DELAY [variable] 


Same as previous except first 
variable specifies the number of 
bytes to be compared. 


Gone idee as a Wait for Interrupt 
instruction. 


Delay the number of milliseconds 
indicated by variable. ee should 
be a decima pores such as 000 
for 1 second. This instruction 
uses a simple time-out loop, and 
the | +04 woes vary with 
penery 3 proc fee speed. If 
accur ‘t ie crit ical, the User 
should ead : afta of 60 Seconds 

od ped the value he 
postres by ine per ontees deviation 
from the one minute delay. 


Save ,Peaisters RO thru RS on the 
stack. This instruction is for use 
at the start of an interrupt 
service routine written in 
language. 


Restore registers RO thru RS from 
the stack then do a return from 
interrupt (RTI) instruction. This 
instruction is for use at the end 
of an MPG interrupt routine. 


Causes a control release as 
described in Section 4.2. 
Execution resumes inline when 
control is returned to this 
program. 


Issue a Bus Initialize to the 
hardware. (Note: Not supported on 
tee nenery Management version of 





eee eee eee 2 ee ee eee 
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User Program Language 
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| WORD 
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(Cont’d) 
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Store the binary value of the 
variable specified as the next word 
in the user pregeen. Octal and 
decimal value re valid for v. 
Also, if a symbolic name is entered 
for v, the address for the tyabol is 
name will be paoetoses. Noté: U 
AT YOUR OWN RISK. 


End of program. Must have the 
highest line ~ gy Causes return 
to the Contro outine when its 
object code is executed during 
program execution. 


— i - 


ee 


C.1 


C.2 
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APPENDIX C 
PREDEFINED SYMBOLIC NAMES 


USER PROGRAM EXCLUSIVE STORAGE 


Each MPG user program has access to 16 locations that are part of 
the program and that have predefined symbolic names. Each 
program uses the same agmagite names, but when two or more 
programs are co-resident, these common names reference different 
phySical locations internal to each program. The valid 
predefined symbols are as follows: 


TMOO TMOY TMOS Tle 

TMO1 TMOS T™13 

TMO2 TMOG T™10 TM14 

THOS T™O7 TM11 TMS 
Likewise, the symbolic names RDIO and WRIO refer to each of the 
two I/0 areas included as part of each eroeres area. The 
locations NBR which are used by he indirect move 

c 


SRC, an T 
instruction (MOVES, and the operation switch word (OPSW) also 
exist separately wilhin each program area. 


RDIO NBR 
WRIO SRC 
DST 


USER PROGRAM COMMON STORAGE 


Each MPG user program also has access to 10 locations that are 
ghysicell common to all pregrens resident at any given time. 
hey are disc accessable by the FILL command. These may be used 
for communication between programs, or variation of parameters by 
command. The valid predefine symbols are as follows: 


COMO COMS 

COM! COME 

COM2 COM? 

COM3 COMB 

COM4 COMS 
The common or shared I/0 area is referenced by the symbolic name 
Tee The middle of this area is referenced By the symbolic name 

FREE CRLF 

MIOL 


A common location containing the ASCII code for a Carriage Return 
and Line Feed can be referenced as CRLF, and used for formatting 
messages. 


a a TT 
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Symbolic Names (Cont'd) 


1 €.3 


The common data buffer is accessable both by MPG commend and by 
each regree, and allows the user te g¢ erate and change data 
without modifying the progres itself. The buffer is 256 bytes 
Hy, and can be referencéd in subdivisions of 16 bytes using the 
following symbols: 


“hOB OR E 


For the FILL command, this buffer cpa be referenced as single 
byte buffer by apne the name or juat 8. If is uSed 
en t BFOO. 


in a program statement, is equivalent t 


MPG PREDEFINED BIT PATTERNS 


Inherent within MPG is the ability to easily generate variable 
length date fields with any Of a seriés of predefined bit 
patterns. These fields may be generated with either the FILL 
program statement or the FI command and are useful when 
checking for failures due to data sened tivity. These patterns 
are identified by pustesee names that are listed below along with 
the bit patterns that each produces: 


PATO 100000 WALKING ONES 


= 


Oo 
iad 
- 
ra) 

. 


PAT1 WALKING ZEROES 


4 Fr pes 


‘WS 


PAT2 EXPANDING ONES 


‘eee 


PAT3 EXPANDING ZEROES 


a 


a ee ee 


en OTE 


Symbolic Names (Cont'd) 


PATY 


PATS 


PATS 


PAT? 


PATE 


PATS 


PATA 


PATB 


: 


ae 


‘ey 


> 
oe 
o 


se 


& 
Pal 
ba] 


a 


ALTERNATE ONES (HORIZ. ) 


ALTERNATE ZEROES (HORIZ. } 


ALTERNATE ONES (VERT. ) 


ALTERNATE ZEROES (VERT) 


OCTAL CHECKERBOARD 


BINARY CHECKERBOARD 


COUNT WORDS 


RPO DISK SERIAL DATA 


ee e———eEEEeoOTEeee ES 
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APPENDIX D 


DEVICE ROUTINES 


DEVICE ROUTINES - GENERAL INFORMATION 


The information unique to a particular device and the 
routines necessary to perform the operations indicated by its 
high level language statements (READ WRITE, SEEK, etc.) are 
contained in an MPG roe segment referred to ae pUevice 
Routine. The Device Routines aré resident on the load 
device and are automatically loaded by MPG when the device is 
specified by model] name for a user progran. 


While device routines are primarily drivers for the various 
PDOP-11 devices, they also provide other services to the user 
eee a8 program and also to MPG. Services for the user 
include: 


- High level songes ¢ functions 

~ Statistic accumulation and display 
- Error detection and display 

- Device registers displa 

- Symbolic names for device registers 


Services for MPG are astesiis extensions of MPG and are 
activated by MPG when nec soern. These services include 
housekeeping functions, snare isplays, and functions 
required for the KILL command. 


The device routines serve as add on components to the basic 
program. Without them it is still possible to write 
progr ans for any device by using the low-level language. 
his basic feature allows progr eamion at the device interface 
level. With them, higher level functions such as Read 
Att geek, Rewind, etc., can be invoked with one MP 
statement. 


A feature provided by the device routines is the specifying 
of device registers by symelic name. In order to reference 
a device’s registers by name, the MPG user must assign that 
device to the preg? se he is Sef tates. As an extension of 
this support, abbreviated Geovies routines exist for all 
devices mentioned in section D.2 even though high level 
functions have not yet been programmed. 


The remaining sections of Appendix D contains documentation 
per taining to the devices for which high level functions have 
een programmed. 


——— 
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D.1 - Device Routines - General Info (Cont'd) 


D.1.1 


COMMON FEATURES IN DEVICE ROUTINES 


Although each device routine is tailored to the device it 
supports, several features are common among gh! full support 
device routines unless otherwise noted. hese features, 
which will be documented only once to avoid nage eee are 
described in this section. When a device routine description 
lists one of these features, it will direct the user to this 
section for detailed information. 


OPSW Special Operation Bit 


One bit in the Operation Switches (OPSW) word associated with 
each user program has been reserved for use as a flag to the 
device routines. This bit, which is called the Special 
Operations (SPOPER) flag, is bit 7 of the OPSW and may or aes 
not be supper ted by a device routine. A typical opp icatio 

of this Bit’s usdge would be its control of the Maintenance 
bit in the device’s registers. When SPOPER is set by the 
user, it would indicate to the device routine that all I70 
operations are to be issued with the device’s Maintenance bit 
set. For other devices it mey have a completely different 
implementation and meaning. herefore, refer to the 
oppiicadle device routine section to determine if this bit is 
utilized and in what manner. 


Remember that the OPSW can be modified either at the command 
level with the OPSW command cr in the user’s programs with 
the LOAD, SET, or CLEAR instructions. 


Information Words 


A total of eight words are available to each device routine 
for use in passing information between itself and the user’s 
proeree. Siz of these words may be implemented as needed for 
he device routine’s own requirements. Examples of these 
words are CYL, HEAD, and SECT for a disk. The other two 
words, which have been sestgnes specific oysbelse names and 
functions for all device routines, are as follows: 


Name Definition 


SIZE A one word location which is loaded by the device 
routine with the number of by es actuall 
transferred on an 1/0 operation that performed 
data transfers. 


ERR A one word location which is cleared to O’s before 
each I/0 operation. Will be set to a value of 1 
if an error was detected on the 1/0 operation. 


FO6 
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Statements 


The following statements will be ony bey by all full support 
device routines and will produce similar results: 


NOWAIT This statement instructs the device routine to go 
into a mode where it returns immediately to the 
next statement in the user’s ore after 
andy Mage any I/0_ operations. This allows the 
user to initiate an 1/0 operation and then sample 
the device vegestors while it is in progress or to 
perform concurrent data operations. 


For communication devices, this mode also allows a 
simultaneous and WR in order to test the 
data loop back provided by the hardware. Multiple 
1/0 operations can be started in parallel as long 
as differant units (lines) are selected. When on 
subsequent statement attempts to select a lin 

that is already in use, the program will wait at 
this point until the initial 170 on any common 
line is completed. 


of device and another I/0 statement is issued 
before a perseanie issued one has terminated, the 
device routine will automatically wait until the 
operation in progress is completed and then 
initiate the next operation. 


If NOWAIT is issued on a@ non-communications type | 


When using this statement, care must be taken to 
ensure that a WAIT is issued after the last 17/0 
operation in the program. Otherwise, an error 
display ote be missed and the final counts will 
not be updated for the last I/0 operation. 


i 
| 
WAIT Resets the NOWAIT mode and instructs the device | 
routine to return to its preset mode of operation. 
In its preset mode, the device routine will wait | 
until the current 170 operation has terminated 
before returning to the next statement in the | 
user’s program. 
! 
i 


COUNTS This statement produces a display of the 
statistical counts accumulated thus far in the 
operation of the user's progr ea. This display 
will be directed to the LIST device (console 
terminal or printer) with the information produced 
being dependent upon the device routine. 
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STATUS 
contents of 
the device assigned to his program. The 
will be directed to the 


register’s contents being identified 


HO6 
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With this statement the user can are the 
the device registers associate 


with 
c)epies 
é 


LIST device with eee 


register’s symbolic name. Porat lt two sets of 


contents will be sieetager. The fir 
registers’ content 

occurred. If there has not been a 
interrupt, these will not be displa 


ed. 
second set consists of their current Contents and 


set is the 
when the last interrupt 


revious 
The 


will always be displayed. For the second display, 
the contents of the registers are retrieved upon 


processing this statement. 


' 0.1.2 COMMON ERROR INFORMATION FOR DEVICE ROUTINES 


When ee an error and if og ae to do so by bits 
8 h { the device routine will 


and 13 in @ progran’s 
shepeee information 
informati 
@inimum will consist of an error I.0. 


pertaining ) error. 


information 1 also be displaye 
the current unit number, the contents of the dev 
at the time the error was detected, and 
mnemonics. For details as to what is produced by a 
device routine, refer to that routine’s section 
appendix. 


the 
on will be directed to the MPG LIST device and as a 
and the line number of 
the current statement in the user’s program. Depending 
the device routine and the type of error additional 
. This usually consists of 
t 


his 


ce registers 
he error bit 
ageei nie 


n this 


There exists within MPG three error mosoapes which on, be 
g ese 


issued during execution of a user opr 
errors will be Sapioges with the prest en s number 
identifier, as? are issued by 

ir y 


routine. The st message a occur when the 


ram. While 


and not by the device 
VERIFY 


statement is esis used within the user’s program. The other 
c 


two messages may Occur when a user program or device 


routine 


is giving contro] back to MPG with it stack having improper 


attributes. These messages and their explanations 
follows: 


DATA ERROR (STMNT # nnnn) 


A data aiscongere has been detected by the 
statement. he d 

displayed folloutag Sais message. Whe 

onl he first ai 


controlled by bit 1 int rogram’s 


are as 


VERIFY 


ata that did not cetera will be 

her to list 

eceapers or all miscompares is 
¢ 


The 


data error count within the device routine will be 


incremented when this error occurs. 
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The value of the stack pe tater was dy tet than 


_ mazimum allowable value when a use 
device oti returned control to 


r progres or 


user 


hy Aw will be terminated ianed ately and. apnea 
é 


ontinued through use of the CONT c 


*#ER# STK TOO BIG 


This error occurs when a weer okt ege ee or 
routine returns control to 
than thirty words on the stack. Since 


device 


and has left more 


storage 


space reserved for stack information is thir y 


words long, stack data would be lost 


for the 


program. Therefore, this is reported as an error 
CONT 


condition and the program is terminated. 


The 


command cannot be used after its occurrence. 


After any error is Stools ed, other than the stack control 
errors, execution of user rer ee will cease, unless 
directed to continue ” one by bi being reset in the 


BE ogram’s OPSW. If the progra 
command is then issued, execution will resume 
next statement in the user’s program. 


stops after an error and the 
at the 


—-----$ + -- 
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MINIMUM SUPPORT DEVICE ROUTINES 


For certain devices MPG provides a minimum level of support. 
This support consists of symbolic names for device registers 
when proprannice a device at the interface level. This 
capability eliminates the need for octal addresses when 
accessing these reg ieters. Also, by at ter inp the device 
register$’ base address, the same er ee may Be run without 
+) toes on a similar device but at a different Unibus 
address. 


In order to reduce file yo the information for all] 
minimum support devices has Been included in one file which 
has the filename of TMSAnm.MPG. When one of these devices is 
specified for a preerse this file will be loaded as its 
device routine. Immed ately after loading the file, code 
wili be executed that deletes the information for all devices 
other than the one specified. The length of the routine’s 
area in memory is then adjusted to the size needed for only 
the specified device’s information. 


each device are listed in the following table Iso listed 
is the displacement that will be added to the device 
registers’ base address for each symbolic name. 


The device model names and the oyreits names suppor te for 
: 


DEVICE NAME DISPL DESCRIPTION 


CD11 CDST +0 Card Status 
cOCcCc +2 Column Count 
CDBA +44 Current Address 
CDDB8 +6 Card Data 
CR11 CRS +0 Card Status 
CM11 CRB1 +2 Card Data 
CRB2 +4 Card Data Compressed 
O0Cil RCSR +0 Receiver Status 
RBUF +2 Receiver Data Buffer 
TSCR +4 Transmitter Status 
TBUF +6 Transmitter Data Buffer 
DN11 ACU +0 Auto Call Unit 
KW11 KWSC +0 R.T. Clock Status 
KWBR +2 R.T. Clock Buffer 


4 a A 
LKS +5006 Line Time Clock Status 


RC11 


RCLA 


D.2 - Minimum Support Device Routines 


(Cont’d) 


Look Ahead 
Disk Address 
Error Status 
Control and Status 
Word Count 
Current Address 
Maintenance 

ata Buffer 


Control and Status 

Word Count 

Current Memory Address 

Disk Address 

Address Extensicn Error 
isk Data 

Maintenance 

Address of Disk Segment 


Command and Status 
Data Buffer 

Track Address 
Sector Address 
Error and Status 


Control and Status 
Data Buffer 


Control and Status 1 
Word Count 
Unibus Address 
Frame Count 
Control and Status 2 
rive Status 
rror 
Attention Summary 
Character Check 
Data Buffer 
Maintenance 
Drive Type 
Serial Number 
Tape Control 


eee Orr oor cor oo 
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DJ11 16-LINE ASYNCHRONOUS SERIAL LINE MULTIPLEXER 


a ae = 1600 
PRESET INTERRUP - 300 
InteReiet veet - 5,5 (READ/WRITE) 
REGISTER NAMES RECOGNIZED 
CSR 
RBUF 
TCR 


Four 


MPG INSTRUCTIONS SUPPORTED 


READ NOWAIT HDUPLX 
WRITE WAIT STATUS 
BREAK FDUPLX COUNTS 
CRESET 


STATISTICAL INFORMATION 


BYTES: Read, Written 

CMNDS: Read, nd Break, Misc. 

INTERRUPTS: Read, 

ERRORS: GrertuniO¥e),, A+ wan paleael 
Parity(P 


OPSW SPECIAL OPERATION BIT SUPPORT 


When Bit 7 (SPOPER) of the OPSW is set, the Maintenance Mode 
Bit (Bit 2@ CSR) will be set prior to issuing each 1/0 data 
transfer command. 


1/0 TIMEOUT 


If a epotaneen interrupt is not received 3 minutes after 

fetssatiag ® “ opere ion, the progres will be aborted and 
user aferaeé. his time is a timate, calibrated on a 
“11/45 with no other user programs running. 


D.3 - DJ11 Device Routine (Cont’d) 





INSTRUCTION DESCRIPTIONS 


F 

READ (D256 INTO RDIO) () = default values 

READ v (INTO RDIO) 

READ v INTO v 
This instruction will cause a data transfer to occur 
between the unit previously assigned to this Device 
Routine and the memory area specilied by the second 
variable. The first variable contains the byte 
count for the transfer. 

| 


READ v INTO v FROM u 


Same as above read except U specifies the units or 
line numbers. Whatever unit numbers were assigned 

have no effect. This allows simultaneous Gata 

transfers on te 16 lines. A typical form of U is 

4-7811 or 4 THRU 7 AND 11. 


TE (D256 FROM WRIO) 
TE v (FROM WRIO) 
TE 
TE 


v FROM v 

v FROM v TO u 
The description for the Read Instruction onesies to 
the Write except for the direction of data flow. 


| BREAK y 
BREAK v ON u 


This instruction causes a break (spacing condition) 

on the assigned unit or on those specified by u as 
in the Read Instruction. The duration at the break 
| is determined by v_ which specifies the number of 

character times to hold the spacing condition. 


CRESET 
This instruction initiates an MOS clear sequence 
which clears the silo and all 16 UART’s. If then 
clears all of the bits in the Control Register. 


eee + ee SS 
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| NOWAIT 
| WAIT 
| Standard implementation - see section 0.1.1. 
| FDUPLX 
Places the DJ11 ina Full Duplex Mode. This is the 
| initial node of a DU11 afters eset or CRESET: 
| 
HDUPLX 
| Places the DJ11 in a Half Duplex Mode. 
| 
STATUS 
Standard implementation - see section 0.1.1. 
COUNTS 


Standard implementation - see section 0.1.1. 


0.3.1 DJ11 ERROR INFORMATION 
This device routine processes errors in the standard fashion 
described in section 0.1.2. 


The unique error messages which may occur in the use of this 
device routine are as Tollows: 


DJ11 TIMEOUT ON 1/0 


An 1/0 operation was begun, but the berating ting 
interrupt was not received. The time allowed fo 

this serervart to occur is approximately three 
minutes when the program is run on the POP-11/4S and 


Standard implementation - see section D.1.1. 
no other programs aré running. 


‘ 


} 
| 
! 
' 
| 
' 
' 
1 


a 
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0.3 - DJ11 Device Routine (Cont'd) 


0.3.2 


DJ11 ERROR: ddd,ddd,etc 


The codes ddd represent mnemonics which are printed 
to indicate which error bits were set. The message 
may contain from one to three codes. The following 
mnemonics may be printed in this message: 


PAR = Received Data Parity Error 
= Framing Error 
= Overrun Error 


DJ11 SAMPLE PROGRAMS 


i. 


Write same data sequentially to units S,6,7 and 14 


0020 WRITE D64 FROM WR 
>0030 WRITE 2 FROM CRLF 
»0040 END 

> DONE 

#RUN 1 


Write same data simultaneously to units 5,6,7, and 14 


#ENTER 1 
°ASGN DEV: DJ11 


»0010 FILL D64 AT WRIO WITH ASCII 

»0020 WRITE D64 FROM WRIO TO 5-7814 

>0030 WRITE 2 FROM CRLF TO S THRU 7 AND 14 
»0040 END 

> DONE 

#RUN 1 


Write different data sequentially te units 1,4 and 11 


#ENTER 1 
°ASGN DEV: DJ11 


»0010 WRITE 016 FROM BFOO TO 1 
»0020 WRITE D16 FROM BFO1 TO 4 
»>0030 WRITE Di& FROM BFOe TO 11 
>0040 END 

> DONE 


*FILL BFOO WITH #TEST MSG NBR | 


BO? ea 


ee + A A 
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“FILL BFO] WITH #TEST MSG NBR 2 
- he WITH #TEST MSG NBR 3 


Write different data simultaneously to units 1,4 and 11 


*EN 1 
°ASGN DEV: DJ11 


Read 1 character from unit le and Write it to units ie 
and 14. Use the operation switch to loop on this 
program. 


#ENTER 1 
°ASGN DEV: DJ11 


0010 READ 1 INTO TMOO FROM le 
>0020 WRITE 1 FROM TMOO TO le AND 14 
>0030 END 


> DONE 

#OPSW1 140920 

#RUN | 

Test the DJ11 using > atthe Sesh pperetics Bit to cause 
data wrap-around. g.joop the vores and 
turn on the eiekcones Bit. Use tes random 
data each time, and sequentially B. all 16 cee 
#ENTER 1 

7ASGN DEV: 0J11,0-15 

0010 FILL pest AT WRIO WITH RANDOM 


se 


»0040 bRITE 
0060 VERIFY DeS& AT RDIO WITH WRIO 
END 


#OPSW1 100214 
#RUN 1 


—— ee + eee eee 


D4 


DL11 SINGLE ASYNCHRONOUS SERIAL LINE INTERFACE 


PRESET ADDRESS - 175610 
PRESET INTERRUPT VECTOR - 300 
PRESET BUS REQUEST - 4,4 (READ/WRITE) 
REGISTER NAMES RECOGNIZED 
RCSR 


RBUF 
XCSR 
XBUF 


MPG INSTRUCTIONS SUPPORTED 


READ WAIT 

WRITE CALL RECV 
BREAK LISTEN STATUS 
CRESET ANSWER COUNTS 


STATISTICAL INFORMATION 


BYTES: Read, Written 

CMNDS: Read, Write, Break, Misc. 

INTERRUPTS: Read, Write 

ERRORS: Overrun(OVR), Framing(FRM), 
Parity(PAR), Data 


OPSW SPECIAL OPERATION BIT SUPPORT 


When Bit 7 (SPOPER) of the OPSW is set, the Maintenance Mode 
Bit (Bit 2 XCSR) will be set prior to issuing each 1/0 data 
transfer command. 


1/0 TIMEOUT 


If a terminating interrupt is not received 3 minutes after 

initiating an 170 ogers ion, the program will be aborted and 

the user fatorned. his time 18 approzimate, calibrated on a 
“11/45 with no other user programs running. 


—-————-} 
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D.4 = DLI1 Device Routine (Cont'd) 


F. INSTRUCTION DESCRIPTIONS 


CRESET 


NOWAIT 


WAIT 


CALL 


(D2ES6 INTO RDIO) () = default values 
y tiNTo RDIO) 


Vv 


This instruction will cause a data transfer to occur 

between the device connected to this DLI1, and the 

memory area specified by the second variable. The 
geal variable contains the byte count for the 
ransfer. 


The description for the Read Instruction apg] Sen to 
the Write except for the direction of data flow. 


This instruction causes a break (spacing condition) 
on the line connected to this DLI11. The duration of 
the break is determined by V which specifies the 
number of character times to hold the spacing 
condition. 


This instruction clears al] the bits in the receive 
coatrel register RCSR and transmit control register 


Standard implementation - see section D.1.1. 
Standard implementation - see section 0.1.1. 


Used to initiate a call thru a MODEM from a ODLIJE. 
ty : pete Terminal Ready, waits for Carrier 
etected. 


ee 
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LISTEN 


Used to wait for an incoming call. Test the Ring 
Indicator and does not proceed until it is detected. 


ANSWER 
Used to answer an incoming call to a OLIIE by way of 
a MODEM. Sets Data Terminal Ready, waits for 
Carrier Detected. 
HANGUP 
Used to terminate a call. Lowers Request To Send 
delays 15 milliseconds then lowers Data Terminal 
Ready. 
SEND 
Sets up line for transmit. Does not cause any data 
transfer. Raises Request To Send, then welts for 
Clear To Send. 
RECV 
Sets up line for data reception. Does not cause any 
data transfer. Lowers Request To Send. 
RDRON 
Sets Bit O of RCSR which turns on the paper tape run 
relay when so attached thru a DLII-A and DLII-C. 
ROROFF 
Clears Bit O of RCSR which turns off the paper tape 
run relay where applicable. 
STATUS 
Standard implementation - see section 0.1.1. 
COUNTS 


Standard implementation - see section 0.1.1. 
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'p.4.1 


0.4.2 
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DL11 ERROR INFORMATION 


This device routine 


described in section D 


The unique error messages which may occur in the use of 


device routine are as Tollows: 


DL11 TIMEOUT ON I70 


An I/O operation was begun, but the terminating 
interrupt was not recelved. The time rk pg Re 

ree 
program is run on the POP=11/45 and 


this ayn ey to occur is approzimate! 
minutes when the 
no other programs are running. 


DL11 ERROR: ddd,ddd,etc. 


The codes ddd represent mnemonics which are printed 
to indicate which error bits were set. The message 
may contain from one to three codes. The following 


mnemonics may be printed in this message: 


PAR = Received Data Parity Error 
FRM = Framing Error 
OVR = Overrun Error 


DL11 SAMPLE PROGRAMS 


1. 


Wait for the phone to ring, answer it, send a wsepege . 
acter 


the co} ling station, then echo back each cha 
received until 

is detected disconnect and terminate the program. 
*#FILL ad WITH #READY FOR DL11 ECHO TEST 

°ASGN DEV: DL11 


0010 LISTEN 
»0020 ANSWER 


»0030 SEND 
0040 WRITE D2& FROM BUF 
»00S0 RECV 


»0060 READ 1 INTO TMOO 
IF TMOO = 377 GOTO 110 


PRITE 1 FROM TMOO 
GOTO SO 


procegecs errors in the standard fashion 


this 


a ’rubout’ is detected. After a ‘rubout’ 


— + 


| 


i 
H 
i 
: 
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»0120 END 
DONE 
#RUN 1 


Provide a program compatible with sample number 1, that 
will initiate a call, receive the 26 byte message and 
print it. It should then transmit, the character 
set one character at a time and print the echoed 
character string. This should be followed by a ‘rubout’ 
and a disconnect. 


#ENTER 1 

°ASGN DEV: DL11 
0010 CALL 
»0020 


»0030 READ Deb 
0040 PRINT Deb AT RDIO IN ASCII 
>00S0 LOAD TNOO WITH 


ORD WIT! 
>»0060 LOAD SRC WITH TMO1 
»0070 LOAD DST WITH RDIO 
>0080 LOAD NBR WITH 1 
>0090 
>0100 WRITE 1 FROM TMOO 
0110 RECV 
>0120 READ 1 INTO TMO1 
>0130 MOVE 
>0140 INCR DST 
>015S0 INCR TMOO 
>0160 IF TMOO < 140 GOT 
>0170 PRINT D64 AT RDIO IN ASCII 
>0180 LOAD WRIO WITH 377 
»0190 SEND 
> WRITE 1 
>0210 HANGUP 
»0220 END 
> DONE 
#RUN 1 


By using the Special Operation bit in the OPSW, use the 
Maintenance Mode for data loopback, do a simultaneous 
Read and Write, and then verify the dala. 


*#ENTER 1 
?ASGN DEV: DL11 


»0010 FILL D256 AT WRIO WITH RANDOM 
> NOWAIT 


0030 RE 
»0040 WRITE 
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*OPSW1 ‘oe 


(Cont’d) 
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WAIT 
»0060 ai DeS6 AT RDIO WITH WRIO 
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A. 


C. 


M.P.G. 


DQ11 NPR SYNCHRONOUS LINE INTERFACE 


T ADDRESS - 160030 
T INTERRUPT VECTOR - 208, 
T REQUEST - 5,5 ( /WRITE) 


cae 
me 
REGISTER NAMES RECOGNIZED BY ALL INSTRUCTIONS 

RCSR 

TCSR 

RERR 

REG 


REGISTER NAMES RECOGNIZED BY SELREG INSTRUCTION 
RBAP Rene CDET SEQ 
RCCP RCC SYNC RBCC 
TBAP TBAS MISC TBCC 
TCCP Tccs TBUF POLY 

MPG INSTRUCTIONS SUPPORTED 


SELREG CALL 
SELSEQ@ LISTEN 

ANSWER 
WRI e. 


READ 

CRESE SEND 
NOWAIT RECV 
WATT FDUPLX 
NOIDLE 


HDUPLX 
IDLE STATUS 
COUNTS 
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D. STATISTICAL INFORMATION 


BYTES: Read, Written 
: Read, Write, Misc. 
INTERRUPTS: Read, Write 
ERRORS: Vertical Redundancy Check (VRC), 
Block Check Character (BCC) 


Revr Non-Exzistent Mem ( iD 

Xmtr Non-Eristent Mem (TNEM) 

Reve and Xmtr Latency (RLAT, TLAT), 
Reve and Xmtr Clock Coss (RCLK, TCLK), 


Data 


E. OPSW SPECIAL OPERATION BIT SUPPORT 


When Bit 7 (SPOPER) of the OPSW is set, the Test Loop Bit 
(Bit 3 MISC) will be set prior to issuing each I/0 data 
transfer command. 


F. 1/0 TIMEOUT 


If a terminating interrupt is not received 3 minutes after 
either ing an 170 ogere ion, the program will be aborted and 
the user informed. This time is approximate, calibrated on a 
PDP-11/4S with no other user programs running. 


a =f 
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G. INSTRUCTION DESCRIPTIONS 


SELREG v 


This instruction enhances the low level lan —_ of 
by allowing the reference of DQ11 Secondar 
Registe s by name. The names +9 by thi 
instruction are listed in section C, and cause the 
popre riate 4 bit code to be loaded in the REG/ERR 
egister. 


SELSEQ v 


This instruction tp ele pee access to the 
two 16 by 16 registers that are available when the 
Protocol option is added. The variable v should be 
the register number in decimal or octal. If it is a 
tag such as TMOO, the contents will be used as the 
register number. This instruction will place that 
number in the proper bits in RCSR. 


D2S6 INTO RDIO) () = default values 
INTO RDIO) 


This instruction will cause a data transfer to occur 

between the device connected to this DQ11, and the 

memory area peees fied by the second variable. The 
Lad variable contaifs the byte count for the 
ransfer. 


WRITE (D2S6 FROM WRIO) 
WRITE v (FROM WRIO) 
WRITE v FROM v 


The description for the Read instruction applies to 
the Write, except for the direction of data flow. 
CRESET 
Sets Master Clear, clears all Secondary and Sequence 
Control Registers, then sets bits per character 
equal to 8 
NOWATT 


Standard implementation - see secticn 0.1.1. 
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Sets up line for data reception. Does not cause any 
data transfer. Lowers Request to Send. 


WAIT 
Standard implementation - see section 0.1.1. 
NOIDLE 
Resets the Idle Mode bit in TCSR. 
IOLE 
Sets the Idle Mode bit in TCSR allowing the 
transmission of IDLE characters whenever Tr GO is 
zero. 
CALL 
Used to initiate a call thru a MODEM from a _ ODQ@11. 
Sets Data Terminal Ready, waits for Data Set Ready. 
LISTEN 
Used to wait for an incoming call. Tests the Ring 
Indicator and does not proceed until it is detected. 
! ANSWER 
Used to answer an incoming call to a DQ11 by way of 
a ; ets Data Terminal Ready, waits for Data 
Set Ready. 
| HANGUP 
Used to terminate a call. Lowers Request to Send 
delays 15 milliseconds, then lowers Data Terminal 
Ready. 
SEND 
Sets up line for transmit. Does not cause any data 
transfer. Raises Request to Send, then waits for 
Clear to Send. 
RECV 
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FDUPLX 
Places the DQ11 in_a Full Duplex Mode. This is_ the 
initial mode of a DQ11 after a CRESET or a RESET. 
Places the DQ11 in a Half Duplex Mode. 

STATUS 
Standard implementation - see section D.1.1. 

COUNTS 


Standard implementation - see section 0.1.1. 


0.5.1 D@11 ERROR INFORMATION 


HOUPLX 
| This device routine processes errors in the standard fashion 
described in section 0.1.2. 

The unique error ey which may occur in the use of this 
device routine are as Tollows: 


D@11 TIMEOUT ON 170 


An 1/0 operation was begun, but the terminating 
interrupt was not rece ved. The time allowed for 
this seterrest to occur is approxinately three 
minutes when the program is run on the POP-1I/4S and 
no other programs aré running. 


DG11 ERROR:  ddd,ddd,etc. 


The codes ddd represent mnemonics which are printed 
to indicate which error bits were set. The message 
may contain from one to eight codes. The following 


mnemonics may be printed in this message: 


TCLK = Transmitter Clock Loss Error 
ey; = Receiver Clock Loss Error 
TLAT = Transmitter Latency Error 
RLAT = Receiver Latency Error 
TNEM = Transmitter Non-existent Memory Error 
een = Receiver pre-eeipnes! Memory Error 
= Receiver Block Check Error 
RVRC = Receiver Vertical Redundancy Error 


eet 
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5.5.2 DQ11 SAMPLE PROGRAMS 


l. 


Test the DQ11 apion the Test Loop bit to cause date 
wraparound. Set the to sees he program and turn on 
the Test Looe bit. Use a printable character as a sync 
character ([). 


#ENTER 

°RSGN DEV: D@11 

0010 

en ae To 

>OITa 

» 0040 FLL 16 AT arse WITH 20040 
»00S0 ID 


NOWAIT 
> D1lé INTO BFOe 


bi ; D16 FROM BFOO 

>0100 NO 

ote PR NT DI6 AT BFOe IN ASCII 
END 


01 

> 

FILL COMO WITH a{[ 

*#FILL BFOO WITH #{[DQ TST MSG 1 
#OPSW 40214 


Modify sample program number 1 to have the DQ11 strip off 
al} dune characters as they are received. Note- Read 
byte count must be decreased. 

*#MODIFY 1 

ENTER STMNT’S 


45 SET RCSR BIT 1 
70 READ D14 INTO BFOe 


> DONE 
#RUN 1 


! 


| 
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3. 


Test the automatic switchover from ey to secondary 
write registers and back again. Use the Test Loop bit as 
in program 1. 


COMO TO REG 
D64 AT BFOY WITH 20040 
0 BFOY 
16 FROM BFOO 
16 FROM BFO1 
ip FROM pat 
16 FROM BFO3 


DLE 
D64 AT BFOY IN ASCIT 





masts Frogram 3 to test the switchover of the read 
é 


registers while using only the primary write registers. 
*MODIFY 1 

ENTER STMNT’S 

»70 READ 016 INTO BFOY 

>80 ) D16 INTO BFOS 

»90 ITE D4 Or eee 

>100 READ D16 INTO BFOb 

>110 READ D16 INTO BFO7 





| D.S - D@11 Device Routine (Cont’d) 


S. 


M.P.G. Page 94 


For systems with the DQ11-BB (PROTOCOL) Option, display 
the contents of the Character Detection and Sequence 
Registers. 


#ENTER 1 
"ASGN DEV: DQ11 


: PRINT + Me! DETECTION REGISTER CONTENTS 
> G 

> 004% Q 

> 0050 REG IN OCTAL 

>0060 INCR TMOO 

»0070 IF TMOO < 20 GOTO 40 

; PRINT : rien REGISTER CONTENTS 

dit Coed THD WITH O 

011 G SEQ 
>0120 SELSEQ TMOO 

>0130 PRINT REG IN OCTAL 

>0140 INCR TMOO 

>0150 IF TMOO < 20 GOTO 120 

0160 


p08 
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RK11 DISK DEVICE ROUTINE 


The RK11 Device Routine, whose filename is TRKAnm. MPG, 
supports the operation of RKOS and RKOS disk drives. Other 
types of disk drives “7 be utilized as long as they do not 
require special considerations in the manipulation of the 
device registers. 


PRESET VALUES AND SUPPORT SUMMARY 
- Valid Model Names and Unit Numbers 


In regis? the “ASGN DEV:" message, two model names (RK11 
and ) are acceptable and may be accompanied by a 
mazimum of 16 unit numbers. For this it 


device the u 
numbers must be in the range of O thru 7. 


- Interface Addresses 


The following are the values preset for the RK11 and ma 
be altered from the console terminal following the "ASGh 
DEV:" message: 

Device Register Base ooggay * 177400 


Interrupt Vector Address = 2 
Bus Request Priority = 5 


- Symbolic Register Names 


The spobelte names listed below may be used to reference 
the 11 device registers in MPG Instructions. The octal 
displacement associated with each name is the value that 


wil be added to the device register base address to 
obtain the actual memory address of the desired register. 
Name Disp] Description 
+0 Drive Status 
RKER +2 Error 
RKCS +4 Control and Status 
+6 Word Count 
+10 Bus Address 
RK +12 Disk Address 


Data Buffer 


E08 
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i 


ee 
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Supported Instructions Summary 


The ros ewig is a summary of the instructions supported 
by MPG for the RK11. Detailed explanations are listed in 
section 0.6.2. 


WRITE = WRERT «= BREST © STEPON 
SEEK ROCK NOWAIT STATUS 
WRLOCK  WRCK WAIT COUNTS 


Information Words 


The five words listed below are used to pass information 
between the user program and the device routine. The 
first three are related and are used to seer itp the 
location on the disk where the 1/0 operation is to Begin. 
The last two words are used to pass information back to 
the user program. All words are initially preset to O’s. 


CYL Aone word pocetiga that contains the cylinder 
number in bits O-7 that will be used in subsequent 
1/0 operations. The contents of CYL and HEAD will 
be shifted to the appropriate bit positions, merged 
into one word with T, and then loaded into . 
This occurs for all 1/0 operations that require a 
disk address. 


HEAD The word location that follows CYL and contains the 
value of the head number to be used (0 or 1). 


SECT This word contains the sector number in bits 0-3. 
Located immediately following HEAD in memory. 


SIZE Standard implementation - see section OD.1.1. 
eeateate are updated by READ, WRITE, ROFMT, WRFMT, 
an ‘ 


ERR Standard implementation - sca section 0.1.1. 


Statistical Information 


Through use of the COUNTS statement or the REPORT command 
statistical information for the program can be dis layed 
on the MPG print device. This information consists of 
octal formatted binary counts under different catagories. 
The catagories and the functions from which data will be 
included under each are: 


ee ae. ee = ee 
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D.6.2 


: He ROFMT 
aviEe + WRITE, WREMT 
READ CMNOS: RDF MT 
aN CMNDS: WRITE, WRFNT 
M : WRCK, WRLOCK, DRESET, CRESET 

: 1] hardware errors 
DATA ERRORS: nvalid unit number errors and errors 
detected by the VERIFY statement. 


INTERRUPTS: Number of entries into the interrupt 
routine. 


- OPSW Special Operation Bit Support 


When bit 7 eg of the OPSW is set, the Inhibit 
Increment (INH BA) bit in RKCS will be set prior to 
issuing each I/0 command. 


DESCRIPTION OF RK11 INSTRUCTIONS 


The RK11 Device Routine supports execution of sizteen MPG 
language statements. For certain functions (READ, WRITE, 
ROFAT, WRFMT, » an ), the desired disk address 
must be loaded into CYL, HEAD, and SECT before performing 
those functions. In the fol lowing cescr iptions, data shown 
enclosed within parentheses indicates the default values if 
ae is entered for the statement’s operands. The v is 
used to indicate a variable operand as defined in Appendix 
B.2. Note that if an odd | bed count is epee tiog in any of 
the following instructions, it wil effectively be 
decremented 4 1 before being used. All 1/0 operations are 
perjoracs with the Stop on Soft Error (SSE) bit set in the 
CS register. 


READ (DeS6 INTO RDIO) 
READ v (INTO RDIO) 
READ v INTO v 


This instruction transfers the number cf bytes, 
indicated by the first v, from the disk to memory 
pogioning at the memory location specified by the 
second v. 


HO8 
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WRITE (D2S& FROM WRIO) 

WRITE v (FROM WRIO) 

WRITE v FROM v 
Transfer the number of bytes from memory to disk 
beginning at the memory location indicated by the 
second v. 

SEEK 
Performs a seek to the disk location specified by 
the current values of . AD and SECT. This 
instruction does not terminate until the Search 
Complete Interrupt is received. 

WRLOCK 
Causes the current disk drive to be write protected. 

ROFMT v INTO v 
This is a read instruction but with the RKCS Format 
(FMT) bit set. Same as READ except that only two 
bytes per sector (Header Word) are transferred to 
memory and default operands are not supported. 

WRFMT v FROM v 
Same as the WRITE instruction but has the Format 
(FMT) bit set. 

ROCK 
This instruction issues the Read Check command on 
the sector addressed by CYL, HEAD, and SECT. 

WRCK v AT v 
Performs the Write Check command at the current 
sector with the number of data bytes specified by 
the first operand at the location specified by the 
second operand. 

CRESET 


A Control Reset command is performed by this 
instruction. No interrupts are involved. 


ne ee 


a a ee 
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DRESET 


The Drive Reset command is issued to the current 
unit with this instruction. This instruction does 
not oh aie: until Search Complete Interrupt is 
received. 


The following instructions do not perform any 1/0 functions 
on the RKIIL. 


NOWATT 


Standard implementation - see section 0.1.1. 


WAIT 


Standard implementation - see section D.1.1. 


STEPUP ¥ 


Easy ieovenestine of the values of CYL, HEAD, and 
SECT is provided with this statement. The variable 
v is a count of the number of sectors that these 
values are to be incremented. Incrementing of the 
HEAD value will occur when the value of SECT exceeds 
decimal 11 and incrementing of CYL will occur when 
HEAD exceeds 1. When the values of the three words 
exceed 202,1,11, wrap around to 0,0,0 will occur. 
For example, if vil, _ the result ‘will be the 
address of the next sector on disk; if v = decimal 
le (Dl2), the new address will be the same_ sector 
but on the next head; if v = decimal 24, @ 
resulting address will be the same sector and head 
but on the next cylinder. 


Note that this instruction (and STEPDN) will operate 
with invalid values in CYL an > ues 
execution. Regardless of their initial contents, 
the contents of all three words will be valid when 
this instruction completes. This allows the use of 
- CYL WI statements followed by 
“STEPUP O” to generate random disk addresses. 


STEPDN ¥ 
This statement is essentially the same as STEPUP but 
provides a decrementin seckiita, for the three 


t 
values. When wrap around occurs, will go from 
0,0,0 to e02,1,11. 


| eeeeeEEE—E—eEeeeEeEeEeee 
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(0.6.3 


Since the values of CYL, HEAD, and SECT are preset 
to zeroes, or S may be used to set these 
words to their desired initial values with one 


tatement. F le, STEPUP D496 would result | 
the decimal velues CL © 30, HEAD = 1, and Sect = 4° 


STATUS 
Standard implementation - see section D.1.1. 
Included with the standard display is the dispiay of 
the current contents of the wirds CYL, HERD, and 

CT. These values do not necessarily reflect the 

current osition of the disk, but merely the 
contents of the three words. 

COUNTS 


Standard implementation - see section D.1.1. 


RK11 ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section D.1.2. Note that the contents of the 
device registers and the CYL, HEAD, and SECT words at the 
time of the error will be displayed for all errors except the 
“INV UNIT 8” error. 


The unique error messages, which may occur in the use of this 
device routine, are as follows: 
DATA ERROR (STMNT # nnnn) 


Standard implementation - see section D.1.2. 


INV DEV I.D. 


When processing a search complete type cf interrupt 
the drive identity in bits 13 thru 15 of RKDS did 
not match the current unit number. 


INV UNIT # 


The current unit number, which is disp) eyes in 
octal, is not in the range of O-7. The ASSIGN 
command may be used to correct the erroneous unit 
number. Increments the data error count. 


+ - 2 
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STATUS ERROR: ddd,ddd,etc. 


This meesent indicates that an error status bit has 
been detected in the RKI1 device registers. The 
codes ddd identify which bits were found with a 
mazimum of five estes listed. The following are the 
codes possible for the ddd fields: 


DRY = Drive Not Ready 


ODPL = Drive Power Low 
DRU = Drive Unsafe 
SIN = Seek Incomplete 
DRE = Drive Error 
OVR = Overrun 
WLO = Write Lock Out 
SKE = Seek Error 
PGE = Programming Error 
NXM = poe Ssistent Memory 
| Our = Dat a Late 
= Timing Error 
NXD = Non-Existent Disk 
NXC = Non-Existent Cylinder 
NXS = Non-Existent Sector 
CSE = Checksum Error 
WCE = Write Check Error 
TIMEOUT ON 1/0 
interrupt was not received The time allowed for 
the iaserrs t tes occur is ap rozimately 22 seconds 
when on e PDP-11/4S and with nd other user 


programs shatetbaa, 


T/0 ON CRESET 
This error, hich y iodicotes that { Ready (RDY) did not 
set within few milliseconds er issuing the 


Control Reset command, may occur pores either of two 
conditions. The first is when the CRESET statement 
is issued and the other is for Bay pas Shorten of any 
other I/0 function. When tai *ioting os y function, 
the device registers are tested for efror Neonditions 
left over from previous functions. If present, the 
Control Reset command is issued to clear these 


After initiating an 1/0 o erating the terminating 
conditions and timeout may occur in this situation. 


: 


! 
| 
| 
; 
' 
? 
| 
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UNEXP SRCH COMP INT 


An unexpected search complete interrupt has 
occurred. This error may occur from either of two 
conditions. The first is when this interr gt occurs 
on an 1/0 operation that should not result in this 
tupe of interrupt (READ, ,. etc). The second 
condition is when the search complete interrupt 
occurs before the normal interrupt on the SEEK and 
DRESET functions. 


UNIT NOT RDY 


proetiotety pr tee to initiating an 1/0 operation, 
the Drive Ready bit (DRY) in the RKDS register was 
found to be reset. 


RK11 SAMPLE PROGRAMS 


The following are sample RK11 programs that perform the 
functions indicated in their descriptions: 


1. This program will] start at cylinder 0, head O, sector O of 
unit 2 and write a sector with random data, read it back 
and then verify the read data with the write data. It 
will then infrement to the next sector and repeat the 
operation with different random data. This entire 
sequence will be repeated 20 times. 


’ : 1,2 

*RDIO = 256 / Sle 

2WRIO = 256 / S12 

DEV REG = / 

?INT VEC = / 

?BUS REQ = 7 

ENTER STMNT’S 

»0010 LOAD TMOO WITH D 

) FILL DSi2 AT WRIO WITH RANDOM 
‘ fee 

»00S0 VERIFY D0S12 AT RDIO WITH WRIO 
»0060  STEPUP 1 

»0070 DECR TMOO 

»0080 IF TMOO > O GOTO 20 

»0090 END 

> DONE 

#RUN 1 
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2. The age program is an example of using the low level 


language an 
the use of big 
program could 
would automatically include s 
reporting. 


at the interface level without 
evel 1/70 statements. An equivalent 
¢ written guies the SEEK instruction and it 

atistic gathering and error 


The purpose of this hw is to initially issue a 
Control] Reset command fo unit O followed by a seek to 
cylinder 8, head O, sector 0. When this seek completes 
then issue a seek to cylinder 128, head O, sector O an 
wait for it to complete. The dual seeks will be repeated 
ten times. Only the pertinent messages are shown in the 


example. 

#ENTER 

7ASGN DEV: RKOS 

*ROIO = 256 7 0 

°WRIO = 2S6 7 0 

0010 LOAD RKCS WITH 1 

0020 LOAD TM10 WITH le 

»0030 LOAD RKDA WITH 400 

>0040 LOAD RKCS WITH 11 

»00S0 IF RKCS BIT 7 CLEAR GOTO SO 
> IF IT Rees GOTO 60 
> L i 10000 

> L nae WITH 11 

»0090 IF RKCS BIT 7 CLEAR GOTO 90 
0100 IF RKDS BIT & CLEAR GOTO 100 
0110 DECR TMIO 

0120 IF TM10 >» O GOTO 30 

01 END 


_— me a a a ee 
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3. The following example consists of two programs which will 


eens the date from one disk to another. Data will be 
copied in four sector blocks from unit O to unit 1. Since 
each program can process only one device at a time, two 
programs that synchronize themselves are needed. 


#ENTER 1 AS RKCPY] 


RDIO = gab / 0 


»0010 LOAD COMO WITH O 
»0020 READ De046 INTO FREE 
‘ LOAD COMO WITH 1 

‘ IF COMO = 1 GOTO 40 
»0070 + IF CYL > O GOTO 20 
»0080 IF HEAD > O GOTO 
»0090 IF SECT > O GOTO 20 
»0100 END 

>DONE 

#ENTER 2 AS RKCPY2 

?ASGN DEV: RK11,1 

*ROIO = 256 / 0 

*WRIO = 256 / O 

0010 FE Gono = 1 GOTO 40 
>0030 _. GBTo 10 

0040 g ITE OEON6 FROM FREE 
qs . COMO WITH O 

> YL >» O GOTO 20 
0080 ~«=C@dWF HERD >» 0 GOTO 
ran IF SECT >» 0 GOTO 20 


08 
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TCll DECTAPE DEVICE ROUTINE 


The TCll Device Routine, whose filename is TTCAnm.MPS, 
supports the execution of 1/0 operations on the TUSG DECtape. 


PRESET VALUES AND SUPPORT SUMMARY 
- Valid Model Names and Unit Numbers 


In reply to the “ASGN DEV:” message, two model names (TC11 
and ) are acceptable and 7 be accompanied by a 
mazimum of 16 unit numbers. For this. device the unit 
numbers must be in the range of O thru 7. 


- Interface Addresses 


The following are the values preset for the TC11 and ma 
be altered from the console terminal following the “AS 
7” message: 


Device Register Base Address = 177340 
Interrupt Vector Address = 214 
Bus Request Priority = 6 


—-——- 


- Symbolic Register Names 


The syabel ic nemes listed below ney be used to reference 
the ICll device registers in MPG Instructions. The octal 
displacement associated with each name is the value that 
will be added to the device register base address to 
obtain the actual memory address of the desired register. 


Name Disp] Description 

TCST +0 Control and Status 
TCCM +2 Command 

TCWC +4 Word Count 

TCBA +6 Bus Address 

TCOT +10 Date Buffer 


- Supported Instructions Summary 


The following is_a summary of the instructions supported 
by MPG for the TC1l. Detailed explanations are listed in 
section 0.7.2. 


i re te ee 
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FWD RONUM STOP STATUS 
REV RDALL S 


+e WRALL NOWAT 
WRI WRTM WAIT 


Information Words 


The three words listed below are used to pass information 
between the user coe and the device routine and are 
initially preset to 0's. 


BLK A one word location used by the user program to 
specify to the device routine the number of the 

Ctape block on which the I/0 operation is to 

begin. The occeptable range of values for this word 

is decinal 0 - - The commands that utilize the 
contents of BLK are: 


READ ROALL 
WRITE WRALL 
SIZE Standard implementation - see section 0.1.1. 


Contents are updated by READ, WRITE, ROALL, WRALL, 
, and WRIM. 


ERR Standard implementation - see section D.1.1. 


Statistical Information 


Through use of the COUNTS statement or the REPORT command 
statistical information for the program can be displayed 
on the MPG print device. This information consists of 
octal formatted binary counts under different catagories. 
The catagories and the functions from which data will be 
included under each are: 


: RONUM 
BYTES WR: WRITE, , WRT 


ate 
READ, RDALL 
RITE CrROS: WRITE, RCL Un si 
MISC CMNDS: STOP, STPALL 
DEV ERRORS: All hardware errors 
DATA ERRORS: Invalid unit and BLK number errors and 
errors detected by the VERIFY statement. 
INTERRUPTS: Muaver of entrigs into the interrupt 
routine. 
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- OPSW Special Operation Bit Support 


Bit 7 of the OPSW (SPOPER) is not supported by the TCil 
device routine and its setting has_no effect upon device 
routine operation. Support for the TC11 maintenance bit 
was not included due to the A ag of providin 
meaningful functions with the corny of opération needed. 
MPG’s low level language lends Itself to this type of 
application and does not require seldom used code in the 
device routine. 


DESCRIPTION OF TC11 INSTRUCTIONS 


The TCll Device Routine supports execution of twelve MPG 
Jpoguege statements. For certain functions (READ, WRITE 

and WRALL), the desired block number must be loade 
into BLK before performing those functions. In the following 
descriptions, data shown enclosed within parentheses 
indicates the default values if nothing is entered for the 
statement’s operands. The v is used to indicate a variable 
operand as defined in Appendiz B.c. Note that if an odd byte 
count is supplied in any of the following instructions, it 
will effectively be decremented by 1 before being used. 


FWD 


The tone direction of all subsequent commands is 
controlled with this statement. FWD, which is the 
reset direction, indicates that all subsequent 
READ . RDALL ‘ and WRTM commands 
are to be performed with the Lape moving in a 
forward direction during data transfers. Block 
searching will still be done in whichever direction 
is needed to arrive at the specified block. This 
command does not cause any tape movement. 


REV 


Similar to the FWD instruction but indicates that 
all data transfers are to be done while ot ope 
in the reverse direction. FWO/REV also controls the 
initial tape direction when searching for a 
specified block. 


oe ne | ee ee er en ene eee ene eee. - eee + = = 
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READ (DeS& INTO RDIO) 
ee v (INTO ROIO) 
RE v INTO v 


This instruction transfers the number of bytes, 
specified by the first v, from Cy tape to memory 
te i at the menery location indicated by the 
setond v. Data will Be transferred starting at the 
block whose number is stored at BLK with the noe 
direction controlled by FWO/REV. Searching for the 
block will occur, if needed. 


WRITE (D2S& FROM WRIO) 

WRITE v (FROM WRIO) 

WRITE v FROM v 
Same as the READ except that the number of bytes 
will be written to tape from memory. 

RONUM v INTO v 
Reads the block number cof the next block into memory 
at the location indicated by the second v. Tape 
direction is controlled by FWO/REV and block 
searching does not occur. The first v is a byte 
count and in effect controls how many block numbers 
will be read. If 2, the block number of only the 
first block is read. {1 6 for example, the numbers 
of the next 3 blocks will be stored in memory. 

ROALL vw INTO v 


This instruction is very similar to the READ 
statement. However, since the TC11 Read All command 
includes two checksum words and transfers 18 bits of 
data at a non-NPR level, special considerations had 
to be taken. Block searching and data transfers 
take press without interrupts. The entire processor 
is dedicated to this instruction suring the search 
and during data transfers. 1/0 operations on other 
devices should not be in progress when initiating 
this command. This is dué to the tight timing 
requirements imposed upon data poryiciag. The time 
used to service another device’s interrupt could 
possibly result in errors on this command. Also, 
since the data consists of eigthteen bits, 
4 ey encountered in ir ging to stuff them 
into ~@ “11 sixteen bit word. The method chosen 
was to place date bits 16 and 17 into bits O and 1 
of the first word of a pair of eqnory words and data 
bits O thru 1S in the second word. This results in 
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WRALL 


WRTM 


STPALL 
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two memory words for every eighteen bit yor d. 
Therefore, the byte count for the L (and L) 
command must be doubled. The reading of one block 
with the RDALL command results in the transfer of 

@ighteen bit words. With a sixteen bit word 
this would result in a byte count of S16. However, 
due to the double word storage format already 
mentioned, the ROALL command aus speci ty a g be 
count of 1032 in order to read all data in one 
block. Byte count totals will reflect four bytes 
read for every eighteen bit word. 


v FROM v 

Essentially the same as the RDALL instruction except 
for the Girection of data transfer. The mode of 
operation and al] special considerations pertaining 
to the ROALL statement apedy to WRALL. Data is 
expected to have bits 16 and 17 in bits O and 1 of 
the first word of a pair of words with bits O thru 
1S in the second word. 

vy FROM v 
This instruction is used to write the timing track 
on DECtapes. FWO/REV controls the tape direction 
and block searching is not performed. Since this is 
a non-NPR function and is performed without 
interrupts, the restrictions for RDALL/WRALL 
concern ng processor contro] and the oper eriee of 
other devices apply to WRTM. Since the data words 
are sixteen bits, the byte count is handled in the 
same manner as for WRITE. Data transfers begin 
occurring as soon as READY sets. 
te command stops tape movement on the current 
unit. 


Used to stop tape movement on all units. 


FOS 
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NOWATT 


WAIT 


STATUS 


COUNTS 
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Standard implementation - see section 0.1.1. 


The NOWAIT mode has no effect upon the ROALL, WRALL, 
and instructions since they always operate in 
the WAIT mode. 


Standard implementation - see section D.1.1. 


Standard implementation - see section D.1.1. The 
first display is the values when the last interrupt 
occurred or at the termination of the last non- 
function (RDALL, WRALL, or WRTM) 


Included with the standard display is the display of 
the current contents of the word BLK. This value 
does not necessarily reflect the current position on 
tape, but merely the contents of this word. 


Standard implementation - see section 0.1.1. 
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TC11 ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section 0.1.2. Note that the contents of the 
device registers and the BLK word at the time of the error 
will be displayed for all errors except the “INV UNIT 8” 
error. 


The unique error messages, which may occur in the use of this 
device routine, are as follows: 


BLK SEARCH ERROR 


While = pahgrea for the specified block prior to 
performing an 1/0 operation, tape direction has been 
reversed siz times without finding the block. 
Possibly due to an invalid block number on tape. 


DATA ERROR (STMNT ® nnnn) 


Standard implementation - see section D.1.2. 


INV BLK 8 


Immediately prior to initiating an I/0 operation 
that requires block searching, the contents of the 
word BLK was not in the range of decimal OQ - S77. 
Since block searching is & programmed function, it 
would be futile to proceed. Increments the data 
error count. 


INV UNIT & 


The current unit number, which is Gieglousd in 
octal, is not in the range of O-7. The ASSIGN 
command may be used to correct the erroneous unit 
number. Increments the data error count. 


STATUS ERROR: dddd,dddd,etc. 


This message indicates th 


é n error status bit has 
been detected in the T 

t 

d 


a 
11 device registers. The 
ts were found with a 
The following are the 
fields: 


codes dddd identify which 
maximum of four belng lis 
codes possible for the dd 


ENDZ = End Zone 
PARE = Parity Error 
MKTE = Mark Reet Error 


D.7 - TC1l Device Routine 


0.7.4 


09 


M.P.G. Page lle 


(Cont’d) 


ILOP = Illegal Operation 
SELE = Selection Error 

KM = Block Missed 

™ = Data Missed 
NEXM = Non-Existent Memory 


TIMEOUT ON 170 


After initiating an I/O operation, the terminating 
interrupt was not received. The time allowed for 
the interrupt to occur is opproziaately two minutes 
and 34 seconds when on the POP-11/95 and with no 
other user programs executing. 


TC11 SAMPLE PROGRAMS 


The following are 


sample TCll programs that perform the 


functions indicated in their descriptions: 


1. 


eee 


Read block O of unit 1 in a forward direction and display 
its contents in octal on the line printer. 


0018 READ DSle 
> PRINT DSl2 AT RDIO IN OCTAL 
0030 END 


> 

> DONE 
#ASSIGN LP11 TO LIST 
#RUN 1 


Using the above program, modify it so that the read is 
per trace in the reverse direction on block number octal 
*#MODIFY 1 

ENTER STMNT’S 

»02 LOAD BLK WITH 20 

»0S REV 

» DONE 


#RUN 1 


_ oo 


| 
| 
| 
| 
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bytes of random data, regs it back, and compare it to the 


repeat the operation. 
repeat the entire test on units 3, 1, and 4 in that 
order. Only pertinent messages are shown in this 
example. 


#ENTER 16 AS TCROWR 
°ASGN DEV: TUS6,2,3,1,4 


00 

01S 

10 WITH RANDOM 
I E 

0060 VERIFY DSle AT FREE WITH WRIO 


TMO8 >» O GOTO 30 


Read the two checksum words and al] data words in block 
number 1 on unit 7 as eighteen bit words. 


#ENTER 9 

He DEV: vu a 

RIO = 70 

»0010 INCR BLK 

> RDALL 01032 INTO FREE 
>0030 END 


ES aS CA, ae 
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TM11 MAGTAPE DEVICE ROUTINE 


The TM1L Device Routine, whose filename is  TTMAnm.MPG, 
supports the execution of t7o operations on the TU1O magtape. 


PRESET VALUES AND SUPPORT SUMMARY 
- Valid Mode! Names and Unit Numbers 


In reply to the “ASGN DEV: message, two mode] names (TM11 
and TUIO) are acceptable and may be eccompanied by a 
mazimum of 16 unit numbers. For this 


device the unit 
numbers must be in the range of O thru 7. 


- Interface Addresses 


The following are the values preset for the TM11 and ma 
be altered from the console terminal following the “ASGN 
DEV:" message: 


Device Register Base Address = 172520 
Interrupt Vector Address = 224 
Bus Request Priority = 


- Symbolic Register Names 


The tyabolie names listed below aay be used to reference 
the 11 device registers in MPG instructions. The octal 
displacement associated with each name is the value that 
will be added to the device cegioter base address to 
obtain the actual memory address of the desired register. 


Name Displ Description 

MTS +0 Status 

MTC +2 Command 

MBRC +4 Byte/Record Counter 
MCMA +6 Current Memory Address 
MTD +10 Data Buffer 

MTRD +12 Read Lines 


~ Supported Instructions Summary 


The ah! ouwing is_a guanes of the instructions puegerted 
,. Ace she TM11. elailed explanations are listed in 
section : 
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READ SPFWD CRESET yal 


WRITE SPREV EVEN We 
WREIRG REWIND ODD STATUS 
WRE OF OFFLIN 6PI COUNTS 


Information Words 


The siz words listed below are used to pass information 
between the user program and the device routine. 


RORB The contents of this word specifies the number of 
times that MPG will attempt to re-read a block on 
ig a CRE or PAE error was detected. Preset value 

0 ke 


WRRB Essentially the same as pore but specifies the 
number of retries for WRITE, WREIRG, and WREOF. 


Preset value is 3 


EOF This word is cleared to zeroes before each I/0 
operation and then set to a yaive of 1 if the End Of 
File bit was set in the MTS register when the 
porateeriog interrupt was processed. This allows 
user detection of EOF’: since they are not treated 
as error conditions. Preset value is 0 


EOT Utilized in the same manner as EOF but reflects the 
status of the End Of Tape bit in the MTS register. 
Preset value is 0. 


SIZE Standard implementation - see section 0.1.1. 
Contents are updated by READ, WRITE, and WREIRG. 


ERR Standard implementation - see section D.1.1. 


Statistical Information 


Through use of the COUNTS statement or the REPORT command 
statistical information for the program can be dis layed 
on the MPG print device. This information consists of 
octal formatted binary counts under different catagories. 
The catagories and the functions from which data will be 
included under each are: 
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ee 


BYTES UR: «WRITE, WREIRG 


Unie cms: Maite, WREIRG, WREOF 


NI : > SPREV, REWIND, OFFLIN, CRESET 

RO : READ 

WR : WRITE, Wwe TRS, WREOF 

& OF EOF’S: pores Fh s encountered during program 
execution. 

& OF EOT’S Number of EOT’s encountered during program 
execution. 


DEV ERRORS: All hard errors and unrecoverable rollbacks 

DATA ERRORS: Invalid unit number and invalid BPI errors 
and errors detected by the VERIFY 
statement. 

INTERRUPTS: Number of entries into the interrupt 
routine. 


- OPSW Special Operation Bit Support 


Bit 7 of the OPSW (SPOPER) is not supported by the TM11 
device routine and its setting has no effect upon device 
routine operation. 


DESCRIPTION OF TM11 INSTRUCTIONS 


The TM11 Device Routine supports execution of sixteen MPG 
language statements. In the followin Sqeeriptions, data 
shown enclosed within parentheses indicates the default 
values if nothing is entered for the statement’s operands. 
The v is used to indicate a variable operand as defined in 
Appendix B.2 


READ (D2S6_ INTO RDIO) 
READ v (INTO RDIO) 
READ v INTO v 


This instruction transfers the number of bytes, 
specified by the first v, from magne ¢ to memory 
beginning at the memory location indicated by the 
second v. Note that when tggciog an EOF block with 
this command, the BYTES RD count will not be 
incremented. 
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WRITE (D2S6 FROM WRIC) 

WRITE v (FROM WRIO) 

WRITE v FROM v 
| 


Same as the READ except that the number of bytes 
will be written to tape from memory. If Seqestory 
to per tere write rollback on thi$ command 
Device Routine will utilize the Write with Extended 
Interrecord Gap command for the writes performed 
during rollback. 

i 


: WREIRG v FROM v 


This instruction is similar to the WRITE statement 
except that only one statement format is supported 
and it uses the TAIL Write with Extended Interrecord 


Gap command. 


This command is used to write an End of File record 
on tape at its current position. 


The number of records specified by the operand vy 
will be spaced over in a forward direction. 
SPREV v 


The number of records specified by the operand y 
will be spaced over in a reverse direction. 


Use of this instruction causes the tape to be 
rewound to the BOT marker. This instruction does 
not terminate until BOT is reached and the second 
interrupt is processed. 


OFFLIN 


Causes the tape to be rewound and then unloaded. 


{ 
i 
| 
i 
! 
! 
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CRESET 


BPI v 


EVEN 


NOWAIT 


STATUS 
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This instruction is used to perform a control reset 
to the controller and tape units. Sets the Power 
Clear bit in the MTC register. 


Used to set the proper Bits Per Inch values into the 
N 8 and DEN S bits in the MTC register. Four 
roloes are valid for v and are as follows: (Preset 


to 
00 = 200 BPI (7 Level) 
O01 = SSE Bi (7 Level) 
10 = 800 (7 Level) 
11 = 800 BPI (9 Level cr core dump 
mode for 7 Level) 


Sets the porits mode to even for reading and 
writing. Alfects all subsequent 1/0 operations. 


Similar to EVEN but sets the parity mode to odd. 
ODD is the preset mode. 


Standard implementation - see section 0.1.1. 
Standard implementation - see section 0.1.1. 


Standard implementation - see section 0.1.1. 


Included with the standard display is the display of 
the current contents of the EOF and EOT words. 


ee nn 8 ee ee ewe 
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Standard implementation - see section 0.1.1. 


' 9.8.3 TM11 ERROR INFORMATION 


This device routine ‘eae errors in the standard fashion 
| described in section D.1.2. Note that the contents of the 
device registers and the EOF and EOT words will be displayed 
for all errors except the “INV BPI” and “INV UNIT 8” errors. 


The unique error agg mee may occur in the use of this 


device routine, are as follows: 


DATA ERROR (STMNT @ nnnn) 


Standard implementation - see section 0.1.2. 


INV BPI VALUE 


The ~ i ng supplied with the BPI statement was not 
one of the values which are valid for the TM11. The 
valid octal values for the 7M11 are OO, O1, 10, and 
ll. Increments the data error count. 


INV UNIT 8 


The current unit number, which is Sieg layed in 
octal, is not in the range cf O-7. The ASSIGN 
command may be used to correct the erroneous unit 
number. Increments the data error count. 


ROLLBACK EXH. 


This error indicates that the TM11 device routine 
hes failed to sucessfully perform a read or write 
type of operation. The nunber of retries attempted 
if controlled by the contents of RORB and ‘ 
This error will not occur if a rollback type of 
error occurs and the number of retries specified by 
the ope icebie word is zero. In this case only th 


STATUS ERROR message will be dispiayed. 
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STATUS ERROR: ddd,ddd,etc. 


This eqenens indicates that an error status bit has 
been detected in the ll device registers. The 
codes ddd identify which bits were found with a 
mazimum of five being listed. The following are the 
codes possible for the ddd fields: 


ILC = Illegal Command 
CRE = Cyclic Redundancy Error 
PRE = Parity Error 


ite = Record Length Error 
BYTE = Bad Tape Error 

NXM = Non Existent Memory 
SLR = Select Remote 

WRL = Write Lock 


TIMEOUT ON 170 


After initiating an I/O operation, the terminatin 
interrupt was not received. The time allowed fo 
the interrupt to occur when on the PDP-11/4S and 
with no other user programs executing is as follows: 


WREOF, OFFLIN = 22 Seconds 

READ, WRITE, WREIRG = 1 Minute & Seconds 
SPFWD, SPREYV = 2 Minutes 12 Seconds 
REWIND = 7 Minutes 


' 


| 
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0.8.4 


TM11 SAMPLE PROGRAMS 


The pola are sample TM11 programs that perform the 
functions indicated in their descriptions: 


1. Beg piontog os on unit 2, write 100 blocks of 1000 bytes 
random Gat rewind the tape, read all blocks, ind < 
Any the tape again. Repeat the program on units 4, S, 


ARG HERD ES MTA IB rr seo 
> TE bt 

> CR 

> IF TMOY >» O GOTO 20 
>0060 REWIND 

>0070 OAD TMOS WITH D100 
> 0080 1000 

»0030 CR 

»0100 IF TMOS >» O GOTO 80 
>0110 ##REWIND 

»0120 END 

> DONE 

#RUN 6 


Z. rite jos byte Sigcks of all one bits to end of tape on 


unit rminate the tape by writing two EOF’s and 
goles ; “rewind. Read the tape forward until detecting 
W 


the two EOF’s and then rewind the tape. 
#ENTER 9 

"ASGN DEV: TU1O,1 

*ROIO = 256 7 O 

°WRIO = 2Sb 7 O 

0010 FILL DYO96 AT FREE WITH 177777 
> WRITE D4096 FROM 

0030 IF EOT = 0 GOTO 

»0040 WREOF 

»00S50 WREOF 

»0060 23 


Ce 


ae a ae - ee 


{ 


| D.8 - TM11 Device Routine (Cont'd) 


M.P.G. Page 122 


0080 IF EOF = 0 GOTO 70 
0090 «I T 

»0100 IF TMO3 <> 2 GOTO 70 
0110 REWIND 

»0120 

> DONE 


#RUN 9 


Test | spacing capabilities of all eight TUIO ta 6 
units yi peed rewinding the tape and writing a 

byte b biotk of randdm data whdse data is saved. Next 
write another block of different renden data, space 
reverse two se read the data in the first block and 
compare it to the date that was saved. Space forward 
over the block last written eng save its write data. 
Repeat this procedure until End Of Vege is detected at 
which time Ag and compare the. final block followed by 
rewinding the tape. 


ENTER 8 AS GRINDR 


"ROL = 286 7 2000. 


°WRIO = 2S6 / 2000 

>0010 REWIND 

0080 FILL D2@000 AT WRIO WITH RANDOM 
> AT WRIO TO FREE 

> F Ke AT WRIO WITH RANDOM 
> KR 

»0070 

>0080 

»>0090 VERIFY De000 AT RDIO WITH FREE 
»0100 IF EOT = 1 GOTO 130 

011 

01 TO 

»0130 READ 

>0140 VERIFY De000 AT RDIO WITH WRIO 
>0150 REWIND 

0160 

» DONE 


é 
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D.9 LPLI/LSLI/LVL1 PRINTERS’ DEVICE ROUTINE 


The LPLI/LSII/LVI11 Device Routine, whose filename § is 
TLPAna. MPG, supports the execution of 1/0 operations on the 
LP11, LS11, and LV11 printers. 


(0.9.1 PRESET VALUES AND SUPPORT SUMMARY 
- Valid Model Nemes and Unit Numbers 


In reply to the ASGN DEV: message, three model names 

(LP11, LS11, and LV11) are accep able. Unit numbers are 

not needed and are not interrogated by the Device Routine. 

However, up to sizteen ney be entered and will result in 

the progras ed fe repeated on the current printer for each 
e 


unit number entered. Effectively acts as a pass count. 


- Interface Addresses 


The following are the values preset for all three printers 
and may be altered from the console terminal following the 
ASGN DEV: message: 


Device Register Base Address = 177514 
Interrupt Vector Address = 200 
Bus Request Priority = 4 


- Symbolic Register Names 


The symbolic names listed below at be used to reference 
the printers’ device registers in MPG instructions. The 
octal displacement associated with each name is the value 
that will be added to the device register base address to 
obtain the actual wenery address of the desired register. 
Note that symbolic names for al] three printers are always 
supported, even though they may reference the same 


a mm ne ee eee es - + 


location. 

Name Displ Description 

LPS +0 LP11 Control and Status 
+2 LP11 Data Buffer 

LPCS +0 LP11 Control and Status 

LPDB +2 LP11 Data Buffer 

LScs +0 LS11 Control] and Status 

LSDB +2 LS11 Data Buffer 

Lyvcs +0 LV11 Control and Status 

LYOB +2 LV11 Data Buffer 


! 
| 
i 
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Supported Instructions Summary 


The following is a@ summary of the instructions ogpger ted 
for the LP11, LSI1, and LVI1 pf senere. Detailed 
eXplanations are listed in section 0.9.2. 


WRITE BUFCLR #§NOWAIT 
SPACE T WAIT 

TOF NOPLOT STATUS 
EOT COUNTS 


Information Words 


The two words listed below are used to pass information 
from the device routine to the user program. 


SIZE Standard implementation - see section De Rete 
Contents updated by WRITE, SPACE, TOF, and EOT. 


ERR Standard implementation - see section 0.1.1. 


Statistical Information 


Through use of the COUNTS statement or the REPORT command 
statistical information for the program can be dis layed 
on the MPG print device. This information consists of 
octal formatted binary counts under different catagories. 
The catagories and the MPG functions from which data will 
be included under each are: 


BYTES WR: WRITE, SPACE, (TOF & EOT in NOPLOT mode) 
WRITE 


MISC CMNDS: SPACE, TOF, EOT, BUFCLR 

DEV ERRORS: All printer errors 

DATA ERRORS: Errors detected by the VERIFY statement and 
commands to the LP11 or LS11. 

INTERRUPTS: Number of entries into the interrupt 


routine. 

ADDITIONAL XFERS DURING INT: 
The number of additional bytes transferred 
to the printer a | one interrupt 
pocviciag. Varies according to printer 
buffer size and the data being printed. 


OPSW Special Operation Bit Support 


Bit 7 of the OPSW (SPOPER) is interrogated only while 
performing WRITE commands. Normally, the Device Routine 
will automatically issue a carriage return and line feed 
(CR/LF) following each while in NOPLOT (printer) 
mode and a Line Terminate in PLOT mode wher the data 
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length is not a aul tiple of decimal 128. If the SPOPER 
bit is set, neither of these automatic features will be 

performed. 

| 


| 0.9.2 DESCRIPTION OF LP1I/LS11/LV11 INSTRUCTIONS 


The LPII/LSII/LVI1 Device Routine supgor ts execution of 
| eleven MPG Janguage statements. nthe ot ious ee 
descriptions, dat shown enclosed within parenthese 

indicates the default values if nothing is entered for the 
statement’s operands. The v is_used to indicate a variable 
operand as defined in Appendix B.2 


WRITE (D2S6 FROM WRIO) 
WRITE v (FROM WRIO) 
WRITE v FROM v 


This instruction transfers the number of bytes 

epost ties by the first v, from penery, beginning al 
the memory lication defined by the sefond v, to the 
printer. Unless inhibited by the SPOPER bit in the 
ore ram’s OPSH, a CR/LF will automatically be issued 
ollowing the data when in piater mode or Line 
Terminatée will be set when in pLo node with the 
data length not a multiple of decimal 128. 


SPACE v 


The number of lines specified by v will be advanced 

in either print or plot mode. In print mode, the 

two CR and bytes (015 and O12) will be sent to 

the printer for each line specified. In plot mode, 

two bytes of O’s are sent to the plotter followed on 

Line Terminate being set. This occurs for eac 

plotter line to be advanced. 
| 
\ 


TOF 


Performs a Top Of Form function in either print or 
plot mode. In print mode, the Form Feed byte (014) 
is sent to the printer. In plot mode, the Remote 
Form Feed bit is set in the C/S device register. 


EOT 
Performs an End Of Transmission function in eith 


eit 
rint or plot mode. In print mode, the End 


er 
Of 
ransmission byte (O04) is sent to the printer. In 


in rn er rn ee rn a ae 


oe 
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BUF CLR 


PLOT 


NOPLOT 


NOWAIT 


WAIT 


STATUS 


COUNTS 


plot mode, the Remote End Of Transmission bit is set 
in the C/S device register. 


This instruction allows the user to clear the 
eoecege ‘ore buffer in the LVI1. The printer buffer 
will be cl preg if in print mode mite the plotter 
buffer wi be cleared if in plot mode. This 
instruction does not use interrupts and has no 
effect if used on the LP11 or LSI1. 


epgtt ise to the Device Routine that all following 
70 functions are to be performed on the plottei 
section of the LVI1. When in plot mode, the 
execution of all previously described 1/0 functions 
will be altered to accommodate the differences in 
the device's interface and operation. This 
statement results in an error if used with an LPll 
or LSI] assigned to the program. 


Resets the PLOT mode and causes al] subsequent 1/0 
operations to be executed in print mode. This is 
the preset mode of operation when starting a 
prog-am. 


Standard implementation - see section 0.1.1. 
Standard implementation - see section D.1.1. 
Standard implementation - see section 0.1.1. 


Standard implementation - see section D.1.1. 


——— 
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0.9 - LPLI/LSII/LVI1 Device Routine (Cont’d) 


0.9.3 


LPII/LS11/LV11 ERROR INFORMATION 

This device routine processes errors in the standard fashion 
described in section 0.1.2. Note that the contents of the 
device registers at the time of the error will be displayed 
for all errors except the “PLOT INV” error. 

The unique error messages which may occur in the use of this 
device routine, are as ollows: 

DATA ERROR (STMNT ® nnnn) 


Standard implementation - see section D.1.2. 


“PLOT” INV FOR LP11/LS11 


When snceetion the preer on, a PLOT statement has 
been encountéred. This command is valid only when 
an LVI11 has been assigned as the device type. 
Increments the data error count. 


RDY NOT SET 


Before initiating an 1/0 transfer, the READY bit was 
not set in the printer’s device register. 


STATUS ERROR 
This message indicates that the ERROR bit has been 
detected in the LPLI/LSII/LV11 Control/Status device 
register. 

TIMEOUT ON 170 


After initiating an 1/0 operation, the terminating 
interrupt was not received. The time allowed for 
the interrupt to occur when on the POP-11/4S and 
with no other user programs executing is 
approximately 22 seconds. 


-—— 
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D.9.4 LPI1/LS11/LV11 SAMPLE PROGRAMS 


The fei toning are sample printer programs that perform the 
functions indicated in their descriptions: 


1. Starting with spaces, print 3 132 byte line of 
haractér on a character LP11 printer. After th 
ine, issue an End Of Transmission character. 


a 1 ee 


REQ = / 

ENTER STMNT’S 
0020 FILE Dice AT ROTO WITH 4 
> Ft AT 18 watt apo40 
> WR 132 FROM WRIC 
»00S0 ADD Dil32e AT RDIO TO WRIO 
>0060 DECR TMOO 

»0070 IF TMOO > O GOTO 40 
»0080 €E0T 
»0090 END 
> DONE 
#RUN 3 


2. Utilize the plot and print modes of an LVI1 by first 
plotting a 16 bit by 16 bit checkerboard pattern for one 
age. Then, advance to the next page, shift to printer 
o8e and print a page of 1 aye nes consisting of the 
standard 64 character ASCII set with each line precessed 
one position. Follow this with an EOT character. 


5S AS PRPLOT 
?ASGN DEV: LV11 
°RDIO = 256 / 0 
°WRIO = 256 / 132 
»0010 PLO 
> OAD TMOO WIT 


0020 L H Des 

»>0030 FILL Dle8 AT WRIO WITH PATE 

>0040 LORD TMO1 WITH D16 

> WRITE D128 

> DECR TMO1 

»0070 IF TMO1 > O GOTO SO 

>0080 FILL 0128 AT WRIO WITH PAT7 

>0090 LOAD TMO2 WITH Dléb | 
| 
} 






10 
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>0100 WRITE D128 

0110 

0120 

>0130 

01 

01 

01 NOPLOT 

01 F Ole AT WRIO WITH ASCII 
01 L WITH D6&0 
0190 32 

45 ROTA 132 AT WRIO 
Ge20 OER >» 0 GOTO 190 
»02 bor 

»0240 

> DONE 


#RUN S 


3. Test the line spacing capabilities of an LSI1 by printing 
lines of E’s with various spacing between them. Then 
check for correct Form Feed operation by issuing a TOF. 
Repeat the test three times on the assigned preter by 
using dummy unit numbers. Note that this test can be 
used on an LV11 in pie mode merety by sy tg a PLOT 
statement at line number . If this is done, E’s will 
not be printed but instead, the plotter’s binary bit 
representation of E’s. 


ENTER 8 

? DEV: LS11,1,2,3 
*RDIO = 256 / 0 

°WRIO = 256 / 126 
>0010 at OLee AT WRIO WITH 4250S 
0020 WRITE Dleb 
0030 SPACE 1 

0040 WRITE D126 
»00S0 SPACE e 

WRITE D126 

»0070 SPACE 3 

0080 WRITE Dl26 
»0090 D10 
0100 WRITE Dleb 
0110 TOF 

0120 END 


> 0 GOTO 100 
IF TM00 > 0 GOTO 30 
OF 
| 
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DH11 PROGRAMMABLE ASYNCHRONOUS 16-LINE MULTIPLEXER 
PRESET ADDRESS - 160020 
PRESET INTERRUPT VECTOR - 300 
PRESET BUS REQUEST - 5,5 (READ/WRITE) 
REGISTER NAMES RECOGNIZED 

SCR 

nC BAR 

LPR BCR 

CAR SSR 


MPG INSTRUCTIONS SUPPORTED 


WRITE HDUPLX Tue 
RBAUD 


BREAK EVEN 

CRESET ODD TBAUD 

WA 1 TP ECHO 

Sratus PuoeTP NOECHO 
OUNTS BITS PRESET 


STATISTICAL INFORMATION 


BYTES: Read, Written 

CMNDS: Read, Write, Break, Misc. 

INTERRUPTS: Read, Write 

ERRORS: Non-existent Mem(NEM), Overrun(OVR), 
preniog tan Parity(PAR), Silo 
Overflow(SOF), Date 


OPSW SPECIAL OPERATION BIT SUPPORT 


When Bit 7 (SPOPER) of the OPSW is set, the Maintenance Mode 
Bit (Bit 9 SCR) will be set prior to issuing each 1/0 data 
transfer command. 


1/0 TIMEOUT 


If a terminating interrupt is not received 3 minutes after 
rp an 1/0 ogere son, the program will be aborted and 
the user informed. This time is approsimate, calibrated on a 
POP-11/45 with no other user programs runring. 


. 


| 
| 
| 
| 
| 
| 
: 


| 
i 
' 
! 
i 
; 
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D.10 - DH11 Device Routine (Cont’d) 


F. INSTRUCTION DESCRIPTIONS 


" 


READ 


CRESET 


( ENTS RDIO) () = default values 

v (INTO RDIO) 

v INTO v 
This instruction will couse a data transfer to occur 
between the unit previcusly assigned to this Device 
Routine and the memory area specified by the second 
variable. The first variable contains the byte 
count for the transfer. 


v INTO v FROM u 
Same as above read except u specifies the units or 
line numbers. Whatever unit numbers were assigned 
have no effect. This allows simultaneous data 
transfers on_up to 16 lines. A typical form of u is 
4-7811 or 4 THRU 7 AND 11. 

(D2S6 FROM WRIO) 

v (FROM WRIO) 

v FROM v 

v FROM v TO u 
The description for the READ instruction ang; tee to 
the WRITE except for the direction of data flow. 

v 

v ON uy 
This instruction causes a break (spacing condition) 
on the egsigned unit or en those specified by u as 
in the READ instruction. The duration at the break 
is determined by v_ which specifies the number of 
character times to hold the spacing condition. 


This instruction sets the Master Clear bit in the 
Sas ten Control Register, then clears all bits in the 


ne a se ee 
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NOWATT 


WAIT 


STATUS 


COUNTS 


SETUP 


nn i wm nn ne re er ee ee ee ee ee ewe 
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Standard implementation - see section 0.1.1. 
Standard implementation - see section 0.1.1. 
Standard implementation - see section 0.1.1. 
Standard implementation - see section 0.1.1. 


This instruction loads the silo alarm level in the 
Silo ue Re yy The be only 2 pencgtem is values of 
v ve or 

othe? slues. ie be + ey when the 
+ HB is run. After an error message is printed, 
he program will take the normal error action as 
determined by the OPSW 


1,2,4, 


All of the following instructions listed, set or 
reset bits in the Line Parameter Register. The 
SETUP ett tao selects which line parameter 
registers wil ngcates a these instructions. 

The unit u can * any ine ." c mbination of lines 
between O and 15, such as 3 T 1S. 


Sets the Receiver speed as indicated in the table. 


Sets the Transmitter speed as indicated in the 
table. 


a ee re eS EES ne ee — 


me ne ee 5 se ee 
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EVEN 


ONESTP 


TWOSTP 


Sets both Receiver and 
indicated in the table. 


Transmitter 
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Speed Table for Receiver and Transmitter 


v(Octal) v(Decimal) 
0 
t BY 
2 De 
3 03 
~ DY 
5 0S 
6 D6 
7 07 
rf : 
13 Bio 
13 Dll 
14 Dle 
1S D013 
16 D014 
17 015 


Sets Even Parity. 


Sets Odd Parity. 


Disables Parity. 


Sets number of stop bits = 1 


Sets number of stop bits = 2 


Baud Rate 


Be5ag° 


e-b +e = 


SreRess 


mm 
aR 


3% 
D 











{ 


i 
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/ 0.10 - DH] Device Routine (Cont'd) 


BITS v 
Sets bits per perecie according to v. Valid 
entries are 5,6,7 and 10 or D8 

ECHO 
Enables Auto-Echo 

NOECHO 


Disables Auto-Echo 


PRESET 


Sets 8 Bits per Character, disables Parity, sets 2 
Stop Bits, 186 Baud, and Full Duplex with No Echo. 


DH11 ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section D.1.2. 


The unique error messages which may occur in the use of this 
device routine are as Tollcws: 


DH11 TIMEOUT ON 1/0 


An 1/0 operation was begun bat the terminating 
interrupt was not received. The time allowed for 
this ag oy to occur is approximately three 
minutes when the program is run on the POP-11/4S and 
no other programs aré running. 


DH11 ERROR:  ddd,ddd,etc. 


The codes ddd represent mnemonics which are printed 
to indicate which error bits were set. The message 
may contain from one to five codes. The following 


mnemonics may be printed in this message: 


PAR = Received Data Parity Error 

FRM = Framing Error 

OVR = Data Overrun Error 

NEM = Non-existent Memory Error 

SOF = Silo Overflow Error (storage interrupt) 


0.10.2 
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BAUD SELECTION CODE > iS 
The user program entered a value with the RBAUD or 
TBAUD sthtedent to select 6 baud rate. This value 


must be from 0 to 15. A value greater than 15 was 
entered. 

# OF CHAR BITS NOT S,6,7 OR 8 
The user program entered a value with the BITS 


statement to select the length of a character. This 


value must be S, 6, 7, or A value not in that 
range was entered. 

SILO ALARM LEVEL OTHER THAN 0,1,2,4,8,16 OR 32 
The user program entered a value with the ALARM 


statement to set the silo alarm level. This value 
must be an haber ay power of 2 between O and 32. A 
value not in that range was entered. 


DH11 SAMPLE PROGRAMS 
1. Write same data sequentially to units 3,4,5 and 11. 


#ENTER 1 

°ASGN DEV: DH11,3,4,5,11 

FILL D64 AT WRIO WITH ASCII 
SETUP 3-5811 

PRESET 


WRITE D64 
00680 WRITE @ FROM CRLF 


3 


&. Write same data simultaneously to units 3,4,5 and 11. 


#ENTER 1 
°ASGN DEV: DH11 


0010 FILL D64 AT WRIO WITH ASCII 
70020 T 


»0030 SETUP 3-5811 
»0040 PRESET 


a an AE al ial Bn a ale 
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»00S0 WRITE D&4 FROM WRIO TO 3-S811 
0060 WRITE 2 FROM CRLF TO 3-S311 
»0070 END 

> DONE 

#RUN 1 


Write different data sequentially to units 5,9 and 1S 
at 300 Baud. 


Write different data simultaneously to units 5,9 and 15. 
Setup for 7 bits per character, even parity 2 stop bits 
at ifp_ baud to line S, 150 baud to line 9 and 300 baud to 


FS Fe Ne a I a SR EE NN i a AEE Oe 


| 
| 
| 
| 
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D.10 - DH11 Device Routine (Cont’d) 


*#FILL BFOO WITH #TEST MSG NBR 1 
*FILL BFOL WITH *TEST MSG NBR 2 
ee WITH #TEST MSG NBR 3 


Read 1 character from unit 3 and write it to units 3,7,8 
and 9. Use the qpereytes switch to eee on this erent 

Note- The PRESET instruction sets the baud rate at 110. 

a rae Boseseery BAUD instruction to match the available 
erminals. 


#ENTER 1 
°ASGN DEV: DH11 


»0010 CRESET 

>0020 SETUP 3 AND 7 THRU 9 

>0030 PRESET 

> 0040 1 INTO TMOO FROM 3 

> 00SL ITE 1 FROM TMOO TO 387-9 
»0060 END 

> DONE 

- fw 140020 


Test the DH11 using the maintenance bit to cause data 
wraparound. Write the same data btu? teneeusse to lines 
0,1,2 and 3 and read back the data into separate memory 
areas. Print the data received. 


#ENTER 1 
°ASGN DEV: DH11 
0010 FILL D64 AT BFOO WITH SO1S 


: 
eee 
ou[0[0 +-— 


BeeebE 
DYVDDYD 
434444 


v 
oOo 
— 
& 
™m 


ND 
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*0PSW 200 
#RUN 1 
7. Modify Program & to run at 9600 Baud. 
*MODIFY 1 
ENTER STMNT’S 
»45 ~~ BAUD 15 
>» DONE 
#RUN 1 


8. Modify Programs 6 or 7 to receive and 


“MODIFY 1 
ENTER STMNT’S 


4S RBAUD S 
47 TBAUD 4 
> DONE 


#RUN 1 


9. Using the Special Operation bit in the OPSW 
mainte 
to test silo overflow error detection. 


#ENTER 1 
°ASGN DEV: DH11 


0010 FILL oo AT WRIO WITH ASCII 
» 0020 


»0030 ira 0-15 
»0040 PRESET 
»00S0 BAUD {S 


NOWAT 
0070 READ D64 INTO RDIO FROM 0-15 
0080 WRITE D64 FROM WRIO TO 0-15 
»0090 WAIT 
0100 PRINT D64 AT RDIO IN ASCII 


M.P.G. 
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transmit at 
different baud rates, causing a framing error. 


the 


mn a in i re ee ee ee ee 


ae ee + ee a 


| 
| 
| 
| 
| 
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D.10 - DHI1 Device Routine (Cont’d) 


10. 


ll. 


Modify Program 9 to run at 4800 Baud and therefore run 
without error. 


#MODIFY 1 
ENTER STMNT’S 
»S0 BAUD 14 
> DONE 


#RUN 1 


Test the silo alarm for proper operation. Use the 
Special Operation bit in the 0 for data loopback. 


>0010 FILL DI& AT WRIO WITH ASCII 
»0020 FILL D16 AT RDIO WITH 20040 
»0030 CRESET 

»>004O0 PRESET 

»00S0 BAUD 1S 

>0060 ALARM D1lb 

>0070 NOWAIT 

»0080 READ DIé 

>0090 WRITE DiS 

»0100 DELAY 01000 

01 PRINT D16 AT RDIO IN ASCII 
01 raiMt § AT CRLF IN ASCII 
>01 WRITE 

>0140 WAIT 

»01S0 PRINT O16 AT RDIO IN ASCII 
01 PRINT 2 AT CRLF IN ASCII 
42 END 

*0PSW 200 

#RUN 1 


Comments: The first prtates line should be blank because 
not enou characters were received to cause 
an interfupt by exceeding the silo alarm 
level. The setond line should contain 16 
ASCII characters. This test can be repeated 
for all valid alarm levels. 


—_---— 
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PC11/PR11 HIGH SPEED PAPER TAPE READER PUNCH 


PRESET ADDRESS - 177550 
PRESET INTERRUPT VECTOR - 70 
PRESET BUS REQUEST - 4,4 (READ/WRITE) 


REGISTER NAMES RECOGNIZED 


PRS 
PRB 
PPS 
PPB 


MPG INSTRUCTIONS SUPPORTED 


STATISTICAL INFORMATION 


BYTES: Read, Write 

CMNDS : Read, Write, Misc. 
INTERRUPTS: Read, Write 

ERRORS: Reader (ROR), Punch(PUN), Data 


OPSW SPECIAL OPERATION BIT SUPPORT 

The setting of Bit 7 (SPOPER) of the OPSW, has no effect on 

this Device Routine. 

1/0 TIMEOUT 

If a terminating interrupt is not received 3 minutes after 

pe tiasieg - 40 ogere ion, the program will be aborted and 
n 


the user ormed. This time is approximate, calibrated on a 
PDP-11/4S with no other user programs running. 


ee 
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F. INSTRUCTION DESCRIPTIONS 


( INTO RDIO) 
case Nt 


BS 


LEADER 


NOWAIT 
WAIT 
STATUS 


COUNTS 






11 
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v INTO v 


v 


This instruction will cause a data transfer to occur 

between the Paper Tape Reader and the memory area 

specified by s @ second variable. The ‘first 
a 


variable contains the byte count for the transfer. 


This instruction will cause a data transfer to occur 
between the memory area specified by the second 
variable and the Paper Tape Punch. The first 
variable contains the byte count for the transfer. 


This instruction causes a blank strip of tap 
punched, whose length in inches is specifie 


eto be 
d by the 
variable. 


Standard implementation - see section 0.1.1. 


Standard implementation - see section D.1.1. 


Standard implementation - see section D.1.1. 


Standard implementation - see section 0.1.1. 
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D.11.1 PC11/PR11 ERROR INFORMATION 
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This device routine processes errors in the standard 


described in section D.1.2. 


fashion 


The unique error messages which may occur in the use of this 


device routine are as Tollows: 


PC11/PR11 TIMEOUT ON 170 
An I/0 operation was begun 


interrupt was not rece ved. 
this ah sy) to occur is 

he program is run on the PDP-1 
no other programs are running. 


minutes when 


PC11/PR11 ERROR: ddd,etc 


PUN = Punch Error (PPS) 
RDR = Reader Error (PRS) 


(D.11.2 PCLI/PRI1 SAMPLE PROGRAMS 


1. Punch a 64 byte ASCII character string, preceeded 


by a 10 inch leader and STX code. 


#ENTER 1 
ASGN DEV: PC1I1 


0010 LOAD TMOO WITH 2 
0020 FILL D64 AT WRIO WITH ASCII 
»>0030 LEADER D10 
0040 WRI Aa TMOO 
> WRITE D6&4 
LEADER D10 
END 


the terminatin 
time allowed foe 


approzimate! 


The codes ddd represent mnemonics which are 
to indicate which error bits were set. 
ay contain one or two codes. 
mnemo 


y, three 


4S and 


printed 
The message 


The following 


nics may be printed in this message: 





—— oe. 
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2. Read and rit the tape groteses in (1), 
ignoring the leader and 


TX character. 

#ENTER 
?ASGN bev: PC11 
| 
| 


»0010 READ 1 
»0020 IF 1 AT RDIO <> 2 GOTO 10 


»0030 4 

»0040 wl D64 AT RDIO IN ASCII 

> 

#RUN 1 . 
3. Read and punch simultaneously. 


#ENTER 1 

7ASGN DEV: PC1l 

20010 FILL D2S& AT WRIO WITH ASCII 
0020 NOWAIT 


en ae es eee | eee eee ree eee oe, SED GS See eee eo, 


en a ee ee o-  e 
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RPOY/RPOS/RPOG DISKS’ DEVICE ROUTINE 


The. RPOY/RPOS/RPOG Device Routine, whose pli denene is 
na. MPG, Bngoer sg the operation of , and RPOb 
disk drives on the standard RHi1 MASSBUS controller and on 
the 11/70 version (RH70) of the RH1I1. 


This Device Routine will gutenetieasty adjust its operation 
based upon the device assigned to if and the CPU that it is 
0 grating on. For the RPOG it will adjust to 2 maximum of 
ais cylinders. Error 


bits gisele d in the ERROR BITS 
message will be peer to the device and the controller. 


Error bits will Be included as necessary for common errors, 
errors errors, and érrors. Also, two 
additional device registers are supported for the ‘ 
PRESET VALUES AND SUPPORT SUMMARY 
- Valid Model Names and Unit Numbers 
In reply to the “ASGN :" message, three mode] names 
(RPO , RPOS and REL, are Feceptable and may be 
unit numbers. For this 


accompanied bye mazimua of 16 


device the unit numbers must be in the range of O thru 7. 


- Interface Addresses 


The following are the values preset for the RPO4Y/RPOS/RPOG 
and may be altered from the console terminal following the 
“ASGN bev: = message: 


Device Register Base Address = 176700 
Interrupt Vector Address = 2S4 


Bus Request Priority = 


- Symbolic Register Names 


The oeeetit names listed below may be used to reference 
the 11/RH70 - RPOY/RPOS/RPOG device registers in MPG 
instructions. The octal displacement associated with each 
name is the value that will be added to the device 
register base address to obtain the actual memory address 
of the desired register. Note that the last two (RPAE and 
RPC3) wil] be supported only when running on an 11/70. 


Name Disp] Register 
RPC] +0 Contro] and Status | 
RPWC +2 Word Count 


ee ee 
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ed re 
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24 nibus Address 
esired seq tar/ Tree Address 

+10 ontrol] and Status 2 

+le rive Stetus 

+14 rror Register 1 

+] Attention Summary 

+ ook Ahead 

+22 ate Buffer 

+24 Maintenance 

+26 Drive Type 

+30 Serial Rumber 

+32 Offset 

+34 Current Cylinder 


+ urrent Culinder 

rror Register e 

+42 Error meg ister 3 
ECC Position 


444 
+46 ECC Pattera 

+50 Bus Address Extension 
+52 Control and Status 3 


REE EROE SE DEERE Roher: 


Supported Instructions Summary 


The 3 eg is a summary of the instructions supported 
by MPG for the RPON/ POS /RPOG Detailed explanations are 
listed in section D.le. 


READ UNLORD NOWAIT ECIOFF 


ROHD CRESET COUNTS 

WRHD APORT Br ON 
WRCK adh OFF 
WRCKHD § RDPSET MTee 

SEEK REL FNT2O COROF F 
SEARCH 000 VVON 
OFFSET § VVOF F 


TEPON EVEN 
RETCTR WAIT ECION 
Certain of the above instructions control the setting of 


internal Stes bits. The preset states of these bits are 
the same as though the following instructions were issued: 


WATT 000 BAIOFF 
APORT ECIOFF §§ CORON 
FMT22 HCIOFF = VVON 
Information Words 
The siz words listed below are used to pass informat 


1 
between the user program and the device routine. A 
words are preset to O's except RTRY which is preset to 3 


on 
}] 


a a i ee 5 ee ee ee 


Cle 


wee ee 


ae me ee ee ee 


ee 


— ee 


me ae cere 0 rr ee eee 2 oe 


Sm mn eee ry" 


' 
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CYL Aone word lecanign that contains the cylinder 
number in bits O-9 that will be used in subsequent 
1/0 operations. The contents of CYL will be loaded 
into RPOC for all I/0 operations that require a 
cylinder address. 


HEAD The word location that follows CYL and contains the 
value of the head (track) number to be used in bits 
O-4. The value in this word and in SECT will be 
sergee and loaded into RPDA for all 1/0 operations 
that require a head and sector address. 


SECT This word contains the sector number in bits O-4. 
Located immediately following HEAD in memory. 


RTRY This word = yi ty the number of additional 
attempts that the Device Routine will try on an 1/0 
operation before deciding that it is unrecoverable. 
Applicable only to those types of errors that 
normally have a possibility of recovery. 


SIZE Standard implementation - see section OD.1.1. 
Contents are updated by READ, WRITE, ROHO, WRHD, 
WRCK and WRCKHD. 


ERR Standard implementation - see section 0.1.1. 


Statistical Information 


Through use of the COUNTS statement and the REPORT 
command, statistical information for the preer es can be 
Sispiaged on the MPG print device. This Information 
consists of octal formatted binary counts under different 
catagories. The catagories and the functions from which 
data will be included under each are: 


BYTES RO: READ, RDHD 

BYTES UR: ITE, WRHD 

BYTES CK: WRCK,  WRCKHD 

READ CMNDS: READ. RDHD 

WRITE CMNDS: WRITE, WRHD 

CHECK CMNDS: WRCK, ’ WRCKHD start eeteak pana 
aie cee: Brest, Crest T, PAKACK, ROPSET, REL, 
DEV ERRORS: All hardware errors that resulted in an 


error report. Correctable ECC errors 
and errors that were recoverable when 
retried will not increment this count. 
CORR ECC ERRORS: Meaber of ECC errors corrected by 
software. 
DATA ERRORS: Invalid unit number errors and errors 
detected by the VERIFY statement. 


me oe wore mm a a ee oe + es see 
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RETRYS: The number of froerrentes for each of 
the seven retruable Mts 7 errors. 
Counts are maintained a or T 
an 
TOTAL RETRYS: Total runt yr of retry attempts on all 
failing I/ /aereste 8. 
INTERRUPTS: Nuaber of ries into the interrupt 
routine. 


- Correctable ECC Errors 


When encountering a correctable ECC error (DCK), this 
device routine will automatical] cornge. the data. The 
contents of the — ATT fia (RPEC1) and the ECC 
Pattern register wil be used to determine the 
bits to be tsfies aaa g oy: ponenees te the data field. 
After the correction has bean’ appl ied e CORR ECC count 
will be incremented and the data fon thy will be resumed 
at its point of interruption. 


This automatic data correction will not be performed if 
the ECI bit is set, if the word +. he is 18 bits (FMTee 
reset), or if the user has entered t COROFF statement. 
In these cases, the DCK will be AB the same as the 
other retryable errors. 


- Retryable Errors 


Seven errors are clessifies as bere ore ne by this device 
routine. When one occurs HCRC, FER, HCE, DOCK 
or WCE), the retry count sailed in the ‘interface’ word 
RTRY is checked for a zero value If zero, an 1/0 
Termination error is reported. If non-zero, the retry 
count for the error and the total core error count are 
incremented by one and the 1/0 operation Is re-issued. If 
the retry is successful, the program wth presees to the 
next statement in the user’s progran. it was not 
successful, the retry count trbm TRY is Seesaentel the 
total retry count is incremented, and the command is 
re-issued. This continues until ei ther the retry is 
successful or the RTRY coun gets ed zero. When the 
latter occurs, the ™ SE HUS TED 1ES* error message wil] 
be issued and the DEV error count will be incremented. 


When prpsageiag ve retries on a I/O operations, the 
grigisel function will just re~issued. The use of 
OffSets and Recalibrate co ae are not employed during 
error recovery in this device routine. 


| 


| 
| 
| 
| 
| 
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Disk Types 


This device routine does not interrogate the Drive Type 
register to determine which type of disk it is operating 
on. It relies solely on the model number assigned to 1. 

y 


rogram. If an has been assigned but it is actual 
+ APOs; the device routine will pracess it as an REDS. 
Dual Controller Operation 


This device routine ng oly operation of disks connected 
to two 4 he through the dual controller option. If the 
disk is busy on the other controller when the device 
routine is roots to issue an I/0 operation, it will wait 
up to 22 seconds for the disk to become available. If it 
does not acquire the disk within that time, a timeout 
error will be reported. In order to make efficient use of 
the disk on a dual controller system, both programs 
operating the disk should issue Release commands through 
use of the REL statement provided by this device routine. 


Instructions And Interrupts 


Certain of the 1/0 functions for the RPOY/RPOS/RPOG disks 
do not normally terminate with interrupts and will not 
have Interrupt Enable set when they are issued. These 
functions are termed Non-Interrupt functions and are: 


DRESET REL 
PAKACK UNLOAD 


After issuing the above functions, the device routine will 
delay a few microseconds and then check the status of the 
error bits. Any found to be set will be reported as a 
Non-Int Termination error. 


The remaining I/0 functions, which are listed below, 
utilize interrupts in their operations: 


READ WRCK OFFSET 
WRITE WRCKHD RETCTR 
RDHO SEEK RECAL 
WRHD SEARCH 


For the above instructions, tests for error conditions 
will be made when the terminating interrupt is received. 


When operating with a dual controller disk and the disk is 
busy on the other controller, interrupts will be enabled 
to allow ATA to signal when the disk has been acquired. 
This feature is utilized for both groups of functions 


a ee ee ee 
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listed previously. Therefore, the interrupt count may be 
incremented on a PAKACK instruction, for example, even 
though it 1s not a result of the command. 


- Accessing The Data Buffer Register 


The contents of the Data Buffer (RPDB) register will be 
stored poly when processing an interrupt with the Output 
Ready (OR) Bit set in the RPUS2 register. At all other 
times, this register will not Be read and its contents 


will be displayed as O's. 


- OPSW Special Operation Bit Support 


Bit 7 of the OPSW (SPOPER) is not supper ted by this device 
routine and its setting has no effect on disk operation. 


DESCRIPTION OF RPOY/RPOS/RPOG INSTRUCTIONS 


The RPOY/RPOS/RPO6 Device Routine supports execution of 
thirty nine MPG language statements. For certain functions 
(READ, . . HD, SEEK and SEARCH), the 
desired disk address must be loaded into CYL, HEAD, and SECT 
before performing those functions. In __ the td Free 
goger tee ons, data shown enclosed within parenthese 
indicates the default values if nothing is entered for the 
statement’s operands. The v is_used to indicate a variable 
operand as defined in Appendiz B.2. Note that if an odd byte 
count is supplied in any of the following instructions, it 
will effectively be decremented by 1 before being used. 


READ (D256 INTO RDIO) 
READ v (INTO RDIO) 
READ v INTO v 


This instruction transfers the number of bytes, 
indicated by the first v, from the disk to memory 
poping ing at the memory location specified by the 
second v. 


WRITE (D2S6 FROM WRIO) 
WRITE v (FROM WRIO) 
WRITE v FROM v 
Transfer the number of bytes from memory to disk 


beginning at the memory location indicated by the 
second v. 
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The following statements do not have default values for their 
operands. 


RDHD v INTO vy 


Reads the four words of sector header data and the 
data field into — using the Read Header and 
Data command. In order to read a complete sector, 
the byte count must reflect the 4 header words. 


WRHD v FROM v 
Performs a format type of operation by sete the 
Write Header and Data command to write the header 
words and data field on disk. 

WRCK v AT v 
Compares the number of data field bytes in memory to 
those at the specified disk location. Uses the 
Write Check Data command. 

WRCKHD v AT v 
Similar to the WRCK command but also compares the 


header data through use of the Write Check Header 
and Data command. 


SEEK 
Performs a seek function to the disk location 
specified by CYL, HEAD, and SECT. This instruction 
does not terminate until the seek is finished. 
SEARCH 


Similar to SEEK but uses the Search command. 


{ 
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The following 1/0 commands do not utilize the contents of 
CYL, HEAD, and SECT in their operations. 


OFFSET ¥v 


RETCTR 


The least significant i bits of the quantit 

specified 4 v will Be loaded into the Offse 

register followed by the Offset command Osten 
issued. Examples of the offset obtained wit 

different octal values of v are: 


y Microinches 
010 +200 
210 -200 
020 +400 
220 -400 
030 +600 
230 -600 
040 +800 
240 -B00 
060 +1200 
260 -1200 


This statement is normal! issued after OFFSET 
statements and results in the Return to Center Line 
command being issued. 


Places the drive in the Standby state by icquing the 
Unload command. Note that this command i$ not 
considered to be terminated until the drive is 
brought back on-line. While the drive is off-line, 
the device routine will check on its status 
spores iactely once every second. Timeout is not 
enabled for this command and the device routine will 
wait an indefinite amount of time for the drive to 
become operable. Upon determining that the drive is 
pperenie again, the device routine will proceed to 
the next statement in the user’s program. 
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RECAL 


CRESET 


DRESET 


PAKACK 


RDPSET 


REL 


Results in the Recalibrate command being issued. 


This statement peg teres a Fontes ller 4 function 
by setting the CLR bit in the RPCS2 register. 


Mpupekoeg ing of the drive is Seegyet esbes by this 
statement’s issuing of the Drive Clear comman 


Causes the Pack Acknowledge command to be issued. 
Causes the Read-in Preset command to be issued. 


Performs a drive clear ard eg leases the drive for 
another port by issuing the Release command. 


The following instructions do not perform I/0 operations: 


STEPUP v 


This command does not perform any 1/0 functions. It 
provites gay eyes be of os 4 ge + CYL 
he operan number of 
sectors that these ag fe: a y i incremented. 
When the SECT word exceeds its mazimum valid value, 
it will be set to O and the contents of 
incremented. When HEAD overflows, it will be at ts 
and CYL will be incremented. When incrementin 
ast the last sector on disk, all three values wil 
e set to O's. Rutomatical ly ggjusts to the number 
of sectors on a track (20 based ypon the 
current setting defined. by the FMTeO/FMTe 
statements and to the number of gu} iadere (411 for 
the RPO4/RPOS vs. 815 for the RPOB). 


ee + + 


ee 
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Note that this instruction and STEPON will operate 
with invalid values in CYL, HEAD, and SECT upon 
execution. Regardless of thelr initial conten $, 
the contents of all three words will be valid when 
this instruction comp) gies. his allows the use of 
the “FILL & AT CYL WITH statement followed 
by “STEPUP 0” to generate random disk addresses. 


STEPON v 


Similar to STEPUP but provides a decrementin 
capability. When all three values are O, the nex 
decrement will result in the decimal values for the 
three words of 410/814, 18, 21/19. 


WAIT 
Standard implementation - see section 0.1.1. 

NOWATT 
Standard implementation - see section 0.1.1. 

STATUS 
Standard implementation - see section 0.1.1. 
Included with the standard display is the display of 
the current contents of the CYL, HEAD and dct 
words. These values do not reflect the current 
pect tiee of the disk, but merely the contents of the 
hree words. 

COUNTS 


Standard implementation - see section 0.1.1. 


The ol lowiog statements define to the Device Routine the 
desired settings of certain bits in the device registers. 
These statementS do not immediately alter the register bits 
but all subsequent I/0 functions and other applicable 


statements will be performed with the bits set as defined. 
APORT 
Indicates that the value of the PSEL bit in RPCS1 is 
to be set to O (UNIBUS Port A). (Preset mode) 


ee ee OS OS 


—_— 
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BPORT 
PSEL will be set to a 1 (UNIBUS Port 8B) on 
subsequent functions. 
FMT22 
Sets the number of sectors on a track to 22 and the 
number of bits in the data field words to 16. FMT22 
is the preset mode and results in the FMT2e bit in 
the register being set to al 
| FMT20 
| Sets the number of sectors on a track to 20 and the 
number of bits for the data field words to 18. 
| Resets the FMT22 bit in RPOF to a 0. 
| 000 
Causes the Parity Select (PAT) bit in RPCS2 to be in 
the O state on subsequent functions. (Preset mode) 
} 
EVEN 
Causes PAT to be set to a l. 
ECION 
Inhibits the Error Correction Code logic by setting 
the ECI bit in the RPOF register to a l. 
ECIOFF 
Allows ECC operation by resetting ECI to 0. (Preset 
mode) 
HCION 
Inhibits the Header Compare function by setting the 
HCI bit in the RPOF register toal. 
HCIOFF 


Indicates that the Header Compare function is to be 
performed by resetting HCI to a O. Preset mode) 
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a a 


BAION 


BAIOFF 


CORON 


COROFF 


VVON 


VVOFF 


Specifies that bus address incre 
performed by setting the BAI 
register to al. 


menting is not to be 


Results in BAI being reset to a QO and bus address 
incrementing being performed. (Preset mode) 


This statement activates the device routine’s 
programmed function of correcting data on which a 
correctable ECC error was detected. When the disk 
etects an error and determines that it can be 
corrected, the device routine will perform the 
correction procedures, increment the C ECC error 
count, and continue running. (Preset mode) 


Disables the pregs onneg recovery of correctable ECC 
errors. When this type of error is detected, an 
error display will result unless it is recoverable 
on retries. 


This statement instructs the device routine to issue 
the Pack Acknowledge command peter to any subsequent 
1/0 functions, other than PAKACK, RDOPSET, or SET, 
if the Volume Valid (VV) bit is not already set. 
This is the preset mode and allows the program to 
run without modification on a pack which has just 
been mounted. 


Inhibits the automatic issuing of the Pack 
Acknowledge command. 


n 
bit in the RPCS2 





ee 
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RPOY/RPOS/RPO& ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section 0.1.2. However, due to the nature of 
this device, additional information is provided to the user. 


The 1/0 function type of instructions are considered to 
execute in two 8 ngee The first is the time it takes to 
acquire the disk and ores it, if needed. The second is 
after the point the specified hunction is issued and until 
after the function terminates. Since error conditions ony 
occur in either stage, this device routine indicates whic 
stage it was in when the error was detected. This is 
accomplished by ene serine the appropriate message of the 
following two messages in the error display: 


BEFORE ISSUING 1/0 CMND 
AFTER ISSUING I70 CMND 


If the error is detected before issuing the specified 1/0 
command and MPG’s Continue (CONT) Command is issued, the 
program will be resumed at the statement on which the error 
was detected. If an AFTER error, the program will resume at 
the next statement in the user’s progran. 


Also included with every error display, other than the 
invalid unit number error, is the following message: 


ERROR BITS: 
ddd, ddd,ddd,ddd,ddd,ddd,etc. 


This message indicates that one or more error status bits 
have been detected in the device registers. The codes ddd 
identify which error bits were found. A sists four byte 
field will be used to list all or as many of the error bits 
as possible. In the folloping list. some codes are 
fist toagieney by an asterisk (#). These codes will be 
included in the message if their bit values are O. All other 
codes are included if they have a value of 1. The following 
are the mnemonic codes supported for the ddd fields: 


Error bits common to all devices: 


pecial Condition 
ransfer Error 

Massbus Control Bus Parity Error 
rive Available 


a 
“PR 


NED = Nonezistent Drive 
NEM = Nonezistent Memory 


le 
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Program Error 
issed yey 


2aaR 


ttention Active 


= 
= Massbus Date Bus Parity Error 
ERR = 
PIP = Positioning In Progress 
#MOL = Medium On-Line 
#DPR = Drive Present 
#DRY = Drive Read 
#VV = Volume Valid 
OCK = Data Check 
a 
= Operation Incomplete 
oe = Drive tein ipter 
WLE = Write Lock Error 
IRE = Invalid Address Error 
AOE = Address Overflow Error 
HCRC = Meader CRC Error 
HCE = Header Compare Error 
ECH = ECC Hard Error 
WCF = Write Clock Fail 
FER = Format rer 
PAR = Parit ror 
RMR s As er ‘Hoditication Refused 
ILR = Illegal Register 
ILF = Ille egal Furction 
ATA7 = Attention Active Drive 7 
ATAR = Attention Active Drive 6 
ATAS = Attention Active Drive S 
ATAH = Attention Active Drive 4 | 
ATAZ = Attention Active Drive 3 
ATALZ = Attention Active Drive 2 } 
ATAL = Attention Active Drive 1 
ATAD = Attention Active Drive O 
PLU = PLO Unsafe 
IXE = Index Error 
NHS = No Head Selection | 
MHS = Multiple Head Selection 
WRU = Write aaeey Unsafe 
TUF = Transition’ Unsafe 
TOF = Transitions Detector Failure 
CSU = Current Switch Unsafe 
WSU = Write Select Unsafe 
CSF = Current Sink Failure 
WCU = Write Current Unsafe 
OCYL = Off Cylinder 
SKI = Seek Incomplete 
DCL = DC Low 
ACL = AC Low | 
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Error bits unique to the RPOY: 


ACU = AC Unsafe 
SOVU = 30 Volts Unsafe 
FEN = Failsafe Enabled 
Hr = Motor Sequence “4 
= -, Unsafe Except Read/Write 
VUF = Velocity Unsafe 
PSU = Pack Speed Unsafe 


Error bits unique to the RPOS/RPOE: 


Abnormal Sto 

Read And Write 

Operator Plug Error 

Write And Offset 
Unsafe 


Error bits unique to the RH70: 


Address A rg Error 

Ci ata Parity Error, Odd Word 
id ata ft reor, Even Word 
WCEOW = Write Check Error, Odd Word 
WCEEW = Write Check Error, Even Word 


BEReR 


aa 


é 


The unique error messages, which may occur in the use of this 
device routine, are as follows: 
DATA ERROR (STMNT 8 nnnn) 


Standard implementation - see section 0.1.2. 


DISK IS OFF-LINE 


Immediately prior to tostien ing an 1/0 operation, 
the Medium On Line bit (MOL) in the RPDS register 
was found to be reset. 


DPR NOT SET 


While waiting to acguire the disk from the other 

controller, an interrupt with the drive's ATA bit 

was received but the Drive Present (DPR) bit in the 
register was not set. 


ae ee oe ee en 
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ERROR ON INITIATION 


Prior to ay a an I/O operation, a condition 
that sets the SC bit in RPCS1, other than an Unsafe, 
did not clear after five attempts to reset it. he 
error bits that caused SC to be set will be listed. 


EXHAUSTED RETRIES 


Upen sateen eng one of the seven it ng errors 
the device foutine has re-issued the failing 1/6 
operation the number of times agpet eee in RTRY 
without successful completeion of the operation. If 
RTRY is initially O, this message will not occur. 


INT WITHOUT ATA 


This message indicates that an interrupt was 
received without the drive’s ATA bit being set and 
it was expected to be set. This. error may occur 
before or after issuing the 1/70 function. When 
pperestos a dual controller disk and it is busy on 
the other controller, the device routine waits for 
an interrupt with ATA set to indicate that it has 
acquired he disk. If an interrupt is received and 
ATA is not set, this error is reported. The other 
case is where an I/0 function (SEEK, SEARCH, etc), 
that normally terminates with ATA, 1s issued and an 
interrupt was received without ATA being set. 


INV ECC BIT PATTERN 


idhen ready to apply the correction to the data on a 
correctable Ete error, the RPEC2 Bit Pattern 
register was found to contain all O's. 


INV ECC BIT POSITION 


INY UNIT 


When ready to apply the correction to the data on a 
correctable €E error, the RPECL Bit Position 
register was found to contain a value greater than 
octal 10041. 


The current unit number, which is Siegloyes in 
octal, is not in the range of O-7. The ASSIGN 
command may be used to correct the erroneous unit 
number. Increments the data error count. 
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1/0 TERMINATION ERROR 
Error bits have been detected in the device 
oe geet when processing a termination interrupt. 
This message occurs for all non-retryable errors and 
retryable errors when RTRY is set to OQ. 

NON-EXISTENT DRIVE 
Immediately after loading a valid unit number (0-7) 
into RPCSH, the Non-Eristent Orive bit (NED) in 
RPCS2 was found to be set. 

NON-INT I70 TERMINATION ERROR 


Error bits were found set in the device registers .< 


few microseconds after issuing one of the 
Roan secereags type of 170 functions (PAKACK, REL, 
etc). 

TIMEOUT ON 170 


After initiating an 170 operation, the terminating 
interrupt was not received. The time allowed for 
the interrupt to occur 18 speraniesters ee seconds 
when on the POP-11/4S and with no other user 
programs executing. 


T/0 ON CRESET 


This error, which indicates that Ready (ROY) did not 
set within a few milliseconds after setting the CLR 
bit i RPCS2, may occur when the CRESET statement is 
issued. 


T/0 ON DISK ACQUIRE 


When ready to issue an 1/0 operation to a disk that 
is busy on the other controller in a dual controller 
configuration, the disk did not become available 
within oppresiactely 22 seconds. Either the disk is 
not in the programmable mode or the program 
operating the disk on the other controller should be 
modified to include Release commands. 
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UNEXP ATA COND 


When processing an interrupt after issuing an 170 
function that should not cause an ATA condition, the 
disk’s ATA bit was found set. 


UNSAFE ERROR ON INITIATION 


Prior to initiating an I/0 ageresien, the Unsafe bit 
(UNS) in RPER] was found bo eset. If the previous 
1/0 operation did not result in an error, this error 
is reported immediately. If there was an error on 
the previous operation, a drive clear will be issued 
to reset the condition. If UNS is still set after 
the drive clear, this error is reported. 


RPO4/RPOS/RPO& SAMPLE PROGRAMS 
The following are sample RPOY/RPOS/RPOS ht Ane that perform 


the functions’ indicated in their descrip 


i. 


10Nns: 


The following program wil! oc? all tracks on the entire 
2 


disk by writing 1 bits to the 
ibit 


be inh 


#ENTER 1 AS TRKCK 

°ASGN DEV: RPOY 
= 26/0 

= 26/1 


? 7 11264 
DEV REG = 176700 . 


°RDIO 
WRIO 


ta fields. Retries will 
ed so as to isolate marginal tracks: 


0 
126 


ENTER STMNT’S 


LOAD RTRY WITH O 

FILL 011264 AT WRIO WITH 177777 
WRITE D11264 FROM WRIO 

WRCK 011264 AT WRIO 

ST ee 

IF 6 AT CYL <> O GOTO 30 

END 


a nme ny 


a nn a 7 
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2. Do 200 pairs of random seeks to an RPOG disk by using the 
STEPUP instruction to generate valid disk addresses from 
random data. Interspersé other instructions to perform 
data transfers of random data and do data validation at 
these disk addresses: 


#ENTER 3 AS RPRAND 
?ASGN DEV: vat 
Let : Sep 7 61 


ENTER STMNT’S 


a a a ee ee ee ee 


0010 LOAD TMOO WITH D200 

10020 FILL & AT CYL WITH RANDOM 

0030  STEPUP 0 

0040 MOVE & AT CYL T0 T 

0050 FILL DSi AT WRIO WITH RANDOM 

> TE 0512 FROM WRIO 
0080  WRCK DSle AT WRIO | 
> FILL 6 AT CYL WITH RANDOM 
01 TEPUP 0 | 
0110 IF & AT CYL = TMO3 GOTO 90 
0120 MOVE 6 AT CYL TO TMOG 

0130 SEARCH 

0140 WRITE 0512 FROM WRIO 

0150 WRCK DSle AT WRIO 

0160 6 AT TMO3 TO CYL 

0180 READ D512 INTO ROIO 

0190 VERIFY OS12 AT ROIO WITH WRIO 

0200 MOVE & AT TMOG TO CYL 

0210 SEEK 

) READ D512 INTO RDIO 

0230 VERIFY 0512 91 RDIO WITH WRIO 

0240  DECR TMOO 

0250 IF TMOO > O GOTO 20 

0260 END 


; 


H13 
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3. Modify the previous program to run on a dual controller 
system and share disk time with the other controller: 
*#MODIFY 3 
ENTER STMNT’S 
0235 REL 
> DONE 


#RUN 3 
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DU11 SYNCHRONOUS LINE INTERFACE DEVICE ROUTINE 


The DULL Device Routine, whose filename is TDOUAnm. MPG, 
supports aie level 1/0 operations for the DUL1 Single Line 
nte 


Synchronous 


rface. 


PRESET VALUES AND SUPPORT SUMMARY 


Valid Model Name and Unit Numbers 


In reply to the “ASGN DEV:” message, one model name (DUI11) 
is accéptable and may be accompanied by a maximum of 16 
unit numbers. For this device unit numbers are ignored by 
the Device Routine but effectively act as a pass count for 
the number of times to repeat the program. 


Interface Addresses 


The following are the values preset for the DUL1 and ma 
be altered from the console terminal following the “Asch 
DEV:" message: 


Device Register Base Address = 160010 
Interrupt Vector Address = 300 
Bus Request Priority = 5,5 (Read/Write) 


Symbolic Register Names 
The symbolic names listed below may be used to reference 
the fu 


1l device registers in MPG instructions. The octal 
St pploceneny associated with each name is the value that 
@ 


wil added to the device register base address to 
obtain the actual memory address of the desired register. 

Name Disp] Register 

RCSR +0 Receiver Status 

RBUF +2 Receiver Data Buffer 

PCSR +2 Parameter Control 

TCSR +4 Transmitter Status 

TBUF +6 Transmitter Data Buffer 


Supported Instructions Summary 


The Sel teuing is a quanery of the instructions supported 
y MPG for the DULL. Detailed explanations are listed in 
section 0.13.2 
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READ 
WRITE SEND EVEN HDUPLX WAIT 
BREAK 


CALL AR 
LISTEN CRESET STRIP PRESET COUNTS 
ANSWER MODE NSTRIP § GENPAR 


Information Words 


The four words listed below are used to pass information 
between the user program and the device routine. 


SYNC A one word location that contains the sync character 
that will be loaded into whenever PCSR’s 
contents are changed. Preset to an octal O26 byte. 


SCNT The word location that follows SYNC and contains the 
count for the number of sync characters to be 
transmitted when beginning a WATTE or a BREAK and in 
a mode other than Isochronous. Preset value is 5S. 


SIZE Standard implementation - see section 0.1.1. 
Contents are updated by READ, WRITE and BREAK. 


ERR Standard implementation - see section D.1.1. 


Statistical Information 


Through use of the COUNTS statement and the REPORT 

command, statistical information for the progres can be 

Stsplazed on the MPG eis! device. This information 
$ 


consis of octal formatted binary counts under different 
catagories. The catagories and the functions from which 
data will be included under each are: 

BYTES ROD: READ 

BYTES WR: WRITE, BREAK 

BREAK CMNDS: BREAK 

MISC CMNDS CALL, LISTEN, ANSWER, READY, 

SEND, RECV, HANGUP 


: 

ERRORS: Hardware errors that resulted in an 
error report. eparate counts are 
maintained for Parity (PhR), Framing 
(FRM), Overrun (OVR), Data Set Change 
(DSC), Data Not Available (DNAY and 170 
Timeout (7/0). The DATA error counter 
is incremented by invalid BITS codes 
invalid M codes, and errors detected 
by the VERIFY statement. 
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INTERRUPTS: Number of entries into the Read and 
Write interrupt routines. 


OPSK Special Operation Bit Support 
it 7 of the OPSW (SPOPER) is not laterronste¢ by fh 
n 


evice Routine and its setting has no effect updn DU 
operation. 


$ 
1 


Parameter Control Register 


This Device Routine does not load the PCSR register until 
one of the statements, that affects PCSR’s contents, is 
encountered. Since it is awrite only register, a base 
value word is maintained by the Device Routine. When one 
of the seg teats statement? is processed, the oper eer iene 
bits wi be modified in the base value and the entire 
word will be loaded into PCSR. This base value word is 
bat tiolis set to a value ( ) equivalent to the PRESET 
instruction being issued. Also, since the sync character 
is part of the PCSR register, the user must issue one of 
the instructions that load PCSR (other than PRESET) after 
e has specified a new sync character. The instructions 
that load PCSR are: 


MODE 
BITS NOPAR 
EVEN PRESET 
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0.13.2 


EEE 


DESCRIPTION OF DU11 INSTRUCTIONS 
The DUL1 Device Routine supports execution of twenty nine MPG 


language 
shown 
values 


enclosed within parentheses indicates 


statements. In the followin sroerte? ons, data 
he default 
if nothing is entered for the statement’s operands. 


The v is used to indicate a variable operand as defined in 
Appendiz B.2 


READ (D2S& INTO RDIO) 
READ v CINTO RDIO) 
READ v INTO v 


WRI 
WRI 
WRI 


TE 
TE 
TE 


( 
v 
¥ 


Transfers the number of data bytes specified + the 
first v from the receiver to the memory address 
specified by the second v. All desired OUL1 
parameters (mode, sync character, which eugtes. 
character length, parity, etc.) must be set up 
before issuing this statement. Actions per forace b 

this statement consist of setting Searc wget an 
Receiver Interrupt Enable in and the processin 

of the resulting interrupts. After the firs 

interrupt is rocessed the Data Set Chasee 
nterrupt Enable bit in RCSR is also set. When the 
ast data byte has been received, Search Sync, 
Receiver Interrupt Enable, and Dala Set Change 
Interrupt Enable will all be reset. 


D2S& FROM WRIO) 
(FROM WRIG) 
FROM v 


Transfers the number of data bytes specified by the 
first v from the memory location specified by the 
second v to the transmitter. All desired OU11 
parameters (Clear To Send, mode, sync character 

which duplex, character ength, arity, etc.) mus 

be set up before issuing this statement. Initially 
resets the Break bit and sets the Send bit in TCSR. 
Then, the Transmitter Interrupt Enable and Data Not 
Available Interrupt Enable bits are set in TCSR. 
When processing the transmitter interrupts, the 
specified number of the current sync character are 
issued unless in Isochronous mode. ex the 
specified number of data bytes are transmitted. 
Following the last data byte, a pad byte of O’s is 
issued. On the interrupt 5! outing the pad byte, no 
data is transmitted but the Send, Transmitter 
Interrupt Enable, Data Not Available Interrupt 
Enable, and Break bits in TCSR are all reset 
pol leued by Request To Send in RCSR also being 
reset. 


L13 
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BREAK v 


CALL 


LISTEN 


ANSWER 


READY 


SEND 


RECV 


In rere this statement is very similar to_ the 
WRI statement with a couple of suqog tions. The v 
is used to specify a byte count for data bytes and a 
memory address is not needed. The Break bit in TCSR 
will be set A to enablin Transmitter 
interrupts. Instead of getting data bytes from 
poner a. a byte of al] 1 bitS (377) will be “sent as 
the Gata Byte. All other actions performed are 
identical to WRITE. 


Sets Data Terminal Ready in RCSR and then tests Data 

et Ready. Does not return to the user program 
until DSR is set. Used to wait while a call is 
being initiated from the DU11’s MODEM. 


Tests the Ring bit in RCSR and returns to the user 
program when Ring is set. Used to wait for an 
incoming call. 


Sets Data Terminal Ready in RCSR and then tests Data 

et Ready. Does not return to the user program 
until DSR is set. Used to wait until the connection 
has been completed for an incoming call. 


Tests the Carrier bit in RCSR. Returns to the user 
program when Carrier is set. 


Sets the Request To Send bit in RCSR and then tests 
the Clear To Send bit. Returns to the user preares 
when CTS is set. This prepares the MODEM for 
transmission. 


ata 


Resets the Request To Send bit in RCSR. This 
prepares the MODEM to receive data. 


13 
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» de 
ppproginately 15 milliseconds and then resets 
Data Terminal Ready bit. This causes the call to 
terminated by disconnecting the 

CRESET 
lears the DUI1 by setti he Master Reset bit i 

Fag After setting notist’*s 36 microsecond delay 
will occur to allow for the one-shot in the OUL1. 


gpesi tied iby the operand v. The three valid values 


for v an modes they select are: 


5 


Isochronous 
External Synchronous 


HANGUP 
Resets the Requegt To Send bit in RCSR, d loys 
ts the 
be 
! 
| 
Internal Synchronous 


MODE v 
Sets the Mode Select bits in _PCSR to the value 
| 


BITS v 
Sets the Word Length Select bits in PCSR to the 
codes for the number of bits which is specified by 
v. The valid values for wv and the bits per 
character selected are: 
S = 5S bits 
8 = bits 
= bits 
10 = 8 bits 
D8 = bits 
EVEN 
Sets the character parity mode to even by egtting 
both the Parity Enable and the Parity Sense Selec 
bits in PCSR. 
000 


Sets the character parity mode to cdd by setting the 
Parity Enatle bit and resetting the Parity Sense 
Select bit in PCS 


SNES. sabe 
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NOPAR 


STRIP 


NSTRIP 


HDUPLX 


SYSTST 


t 
Disables character parity porezsties and coy. by 
Scobey both the Parity Enable and the Parity 
ec 


Sense Select bits in PCSR. 











Inhibits sync characters {rg¢m being peers on as 
receiver data characters by setting the Strip Sync 
bit in RCSR 


Permits sync characters to 


@ recognized as receiver 
data characters by reset 
RCSR. 


ing the Strip Sync bit in 


Enables Full Duplex mode 


{ operation by resetting 
the Half Duplez bit in TQsR. 


Enables Half Duplex mod 


of operation by setting the 
Half Duplex bit in TC 


Sets the DUL1’s mode Normal by resetting both 
Maintenance Mode Selegt bits in rcér to O's. 


Sets the DUL1’s mode to System Test . setting both 
Maintenance Mode Select bits in TCSR to 1’s. 


me eee. + 
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PRESET 


CYSYNC v 


This statement sets al] OUL1 control bits and 
arameters to preset values with one statement. 
his statement is equivalent to resetting the Break 

bit in  TCSR and then issuing the following 

individual statements: 


LOAD SCNT WITH 
MODE 3 


(Internal Synchronous) 


AT v 


Using the byte count specified by the first v and 
beginning at the memory address specified by the 
second v, this instruction will convert the data 
a he to the correct parity bit placement and 
character length currently in effect. Effectively 
enevates porens the same as would be seen when the 
ata is transmitted and received. Automatically 
og eer to the number of character bits currently in 
effect (BITS or PRESET) and the current parity mode 
. 3 » or PRESET). Useful for 
boneet site write data so that it may be compared 
with the data actually received. 


AT v 


Using the byte count specified by the first v and 
the memory address specified by the second v, this 
instruction will scan the data bytes and complement 
an data bytes that match the curren syne 
character. The comparison is based upon he 
character length socreasty in effect (BITS or 
PRESET). Useful for eliminating oyac characters in 
random data or characters hat become sync 
characters when the character length is changed. 


Standard implementation - see section 0.1.1. 
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5.13.3 
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NOWATT 

Standard implementation - see section 0.1.1. 
STATUS 

Standard implementation - see section 0.1.1. 
COUNTS 


Standard implementation - see section 0.1.1. 


DU11 ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section O.1.2. Refer to that section for 
general information concerning error reporting. 


The following message may accompany any hardware type of 
error message: 


ERROR BITS: ddd,ddd,ddd,etc. 


This message indicates that one or more error status bits 
have been detected in the device registers. The codes ddd 
toq pe which error bits were found with codes being 
included if they have a value of 1. The following are the 
mnemonic codes supported for the ddd fields: 


RX = Receiver Error 
= Overrun Error 
FRM = = Framing Error 
POR s peri te Error 
DNA = Data Rot Available 


The unique error messages, which may occur in the use of this 
device routine, are as follows: 


DATA ERROR (STMNT & nnnn) 


Standard implementation - see section 0.1.2. 


en 
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DATA SET CHG INT ON READ 


Indicates that the Data Set Ghonge bit in RCSR was 
set when processing an interrupt during read data 
transfers. On the first interrupt for each 
instruction, this bit is ignored; however, it is 
tested on all subsequent interrupts. 


ERROR ON READ DATA XFER 


When processing @ receiver interrupt during data 
transfers, one or more error bits were found set in 

-. The error bit mnemonics will be displayed 
with the BITS message. 


ERROR ON WRITE DATA XFER 


When processing a transmitter interrupt during data 
transfers, the Data Not Available bit was set in 

This bit’s mnemonic will be displayed in the 
BITS message. 


MODE NOT 0, 2 OR 3 


While executing the program, the MODE statement was 
bein procesece an he operand “ot for the 
instruction did not have a value of Q, 2, or 3. 
This is an operator programming error and increments 
the DATA error counter. 


& OF CHAR BITS NOT S, 6, 7 ORB 


While executing the progres, the BITS statement was 
being grececene an he operand guppligd for the 
instruction did not have a value of 5, 6, 7, or O08 
{octal 10). This is an cperator programming error 
and increments the DATA error counter. 


TIMEOUT ON 1/0 


After initiating a READ, WRITE, or BREAK operation, 
the heptane ieg interrupt was not received. The 
time allowed for the interrupt 0 occur 18 
aperesiaatels 3 minutes on the “11/45 and with no 
other user programs executing. Increments the 1/0 
error counter. 


me eee oe 
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0.13.4 DU] SAMPLE PROGRAMS 


| 
The pete are sample DU11 programs that perform the 
functions indicated in their descriptions: 
! 
! 


1. Using 201A MODEMS and ‘" Guho~Hacwer Date Set, the 
follOwing two programs will establish a connection between 
two DULI"s on the same CPU. Messages will be issued to 
list the progress of each program. Note that these 
programs may also be used on separate CPU's. 


“ENTER 1 AS CALLEE 

°ASGN DEV: DULI 

°RDIO = 256 7 0 

°WRIO = 256 / 0 

°DEV REG = 160010 / 160120 

?INT VEC = 000300 / 470 

"BUS REQ = 5,5 / 

ENTER STMNT’S 

0010 CRESE 

»0020 PRINT #WAITING FOR CALL 

»0030 LISTEN 

»0040 PRINT #I GOT A RING 

>00S0 ANSWER 

) PRINT *I ANSWERED 

> RECV | 
»0080 READY | 
) PRINT *CALLEE IS READY 
»010D END | 
#ENTER 2 AS CALLER 
°WRIO = See / 
°DEV REG = 160010 / 160130 
?INT VEC = 000300 / S00 | 
BUS REQ = 5,5 / | 
ENTER STMNT’S | 
»0010  CRESET | 
0020 PRINT #INITIATE CALL 
»0040 PRINT *CONTACT MADE 
0050 READY 
»0060 SEND : 
50070 PRINT #CALLER IS READY | 
»0080 END 
> DONE 


#PUN 1,2 
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2. With a connection established between two DULI’s, have one 


rogram (89) send ASCII data to another (#8) and then have 
he same data sent back to the or iginesios DUL1 where the 
received data will be compared with the original data. 
The preset mode provides for 8 bits, odd parity, and 
Internal Synchronous mode. 


0020 

0030 FILL D64 AT RDIO WITH O 
»0040 READ D64 INTO ROIO 

»00S0 PRINT D64 AT RDIO IN ASCII 


>0060 
>0070 WRITE D64 FROM RDIO 
>0080 END 
> DONE 
#ENTER 39 AS DUWREY 
DEV: DU11 
*ROIO = 256 / 64 
°WRIO = 2S6 / 64 
*DEV REG = 160010 / 160130 
7INT VEC = 000300 / S00 
"BUS REQ = 5,5 / 
ENTER STMNT’S 
0010 SET 
>0020 FILL D64 AT WRIO WITH ASCII 
>0030 $$ CVSYNC D&4 AT WRIO 
»>0040 NO 
»00S0 WRITE 064 FROM WRIO 
»0060 RECV 
»0070 a D64 AT RDIO WITH O 
> 0080 D64 INTO RDIO 


0090 PRINT D64 AT _RDIO IN ASCII 
»0100  GENPAR D64 AT WRIO 
tae eenlFy D64 AT RDIO WITH WRIO 


#RUN 6,9 


G14 
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3. Modify the reyes in Sample #2 so that 6 bits with no 
¢ used. ince siz bit information is not 
| 


arit il 
irectl “printable also modify the data print format. 
Note that the GENPAR statement will automatically convert 


the original transmit data to the same format as the 
received data for the comparison. Also, the CVSYNC 
statement will ensure that the siz data bits of each data 
character does not match the sync character. 


“MODIFY §& 
»001e BITS & 
0014 

»00S0 PRINT D6&4 AT RDIO IN OCTAL 
» DONE 


*#MODIFY 9 
»00le BITS & 
»0014 NOPAR 

»0090 PRINT D&4 AT RDIO IN OCTAL 
»DONE 


#RUN 8,9 


4. Using the System Test mode, wrap random data within the | 
DULL to test the different parity modes of the receiver 
and the transmitter. Alter the number of and value of the 
sync characters sent. Use the CVSYNC instruction to 
ensure that 1 characters are not included in the random | 
data. Use the GENPAR instruction to convert the original 
write data to the same format as what should have been 
received. seeonity and print the first 14 bytes of the | 
data sent and the data received. Aig repeat the 
program three times by using dummy unit numbers. 
*#ENTER S AS DUTEST 
°ASGN DEV: DU11,0,1,2 
"ROIO = 256 7 200 
°WRIO = eS6 / 200 

| 
! 


ENTER STMNT’S 


0020 SET 

0030 LOAD SYNC WITH O44 
»>0040 LOAD SCNT WITH Dle 
»00S0 +=BITS 7 

0060 SYSTST 

»0070 PRINT #0DD PARITY 
0080 


70090 LINK 2000 


' 
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B58 


5 


#RUN 5 


Ss. Modi ty 
0 


the I 


Routine (Cont'd) 
PRINT #EVEN PARITY 
EVEN 


LINK 2000 

PRINT *#NO PARITY 

NOPAR 

bhi 2000 

Fl AT WRIO WITH RANDOM 
FI AT ROIO WITH O 


INTO ROIO 
FROM WRIO 


NT 8WRIO = 
NT D14 AT WRIO IN OCTAL 
NT 8RDIO = 
NT D14 AT RDIO IN OCTAL 
a AT WRIO 
AT RDIO WITH WRIO 
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Sample program ® 4 to utilize S bits and operate in 
chronous mode instead of Internal Synchronous. 


*MODIFY S 


»00S0 
»00SS 


#RUN S 


BITS S 
MODE 0 


2 ie ee Ce 
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RKO& DISK’S DEVICE ROUTINE 
The RKO& Device Routine, whose 


supports the operation of 
UN controller. 


name is TREAnm.MPG 
drives on the RkKb1L 


PRESET VALUES AND SUPPORT SUMMARY 
- Valid Model Name and Unit Numbers 


In reply to the “ASGN DEV:" message, one model name (RKO6) 
is acceptable and may be accompanied by a maximum of 16 
unit numbers. For this device the unit numbers must be in 
the range of O thru 7 


- Interface Addresses 


The following are the values preset for the RKO& and ma 
be altered from the console terminal following the “ASG 
DEV:" message: 


Device Register Base Address = 177440 
Interrupt Vector Address = 210 
Bus Request Priority = 5 


- Symbolic Register Names 


The symbol ic names listed below may be used to reference 
the 61l - RKOB device registers in MPG instructions. 
The octal displacement associated with each name is the 
value that will be added to the device register base 
eceress to obtain the actual memory address of the desired 
register. 


Name Disp] Register 
RKC1 +0 Control and Status 1 
RKWC +2 Word Count 
RKBA +4 Unibus Address 
RKDA +6 Desired Sector/Track Address 
RKC2 +10 Control and Status 2 
DS +12 Drive Status 
aaee +14 rror Wegigter 1 
RK +16 ttention Summary/Offset 
RKDC +20 = Desired Cylinder 
NOTU +22 Not used 
DB +24 Data Buffer 
RKM1 +26 Maintenance 1 


ECC Position 


| 
| 
: 


| 
! 
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RKPA +32 ECC Pattern 
RKM2 +34 Maintenance 2 
RKM3 +36 Maintenance 3 


Supported Instructions Summary 


The following is a -—" of the instructions supported 
y t or the RKO6. Detailed explanations are listed in 
section 0.14.2. 


READ ION 
WRITE RE NOWAIT § BAIOFF 
RDHD CORON 
WRHD DRESET COUNTS COROFF 
WRCK SRESET  FMT22 ODD 
ein STEPUP = FMTe0 EVEN 


STEPODN PAKACK REL 
OFFSET § SELDRI BADSEC 


Certain of the above instructions contro] the setting of 
internal otes bits. ¢ preset states of these bits are 
the same as though the following instructions were issued: 


WAIT 00D BAIOFF 
CORON FMT22 


Information Words 
The siz words listed below are used to pass informat 


i 
between the user program and_ the device routine. A 
words are preset to O’s except RTRY which is preset to 3 


on 
1] 


CYL Aone word location that contains the cylinder 
number in bits O-9 that will be used in subsequent 
I/O operations. The contents of CYL will be loaded 
into RKDC for all I/0 operations that require a 
cylinder address. 


HEAD The word location that follows CYL and contains the 
value of the head (track) number to be used in bits 
O-2. The value in this word and in SECT will be 
merged and loaded into RKDA for all I/0 operations 
that require a head and sector address. 


SECT This word contains the sector number in bits O-4. 
Located immediately following HEAD in memory. 


MSGA This word contains the Message-A obtained with the 
SELDRI command. 


MSGB This word contains the Message-B obtained with the 
SELDRI command. 


K14 
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RTRY This word s ogi tigs the number e! additional 
stan by that the Device Routine will try on an 1/0 
operation before deciding that it is unrecoverable. 
Applicable only to those types of errors that 
normally have a possibility of recovery. 


SIZE Standard imp] tati - ti sets 
Contents are’ updated by READ, WRITE, ROHD, » and 


ERR Standard implementation - see section 0.1.1. 


Through use of the COUNTS statement and the REPORT 
command, statistical information for the progres can be 
Sicploxed on the MPG print device. This information 

s of getel formatted binery counts under different 
catagories. The catagories and thé functions from which 


- Statistical Information 
| 

data will be included under each are: 
j 


BYTES RD: READ, RDHD 
BYTES WR: WRITE, WRHD 
BYTES CK: WRCK 

oes Te, er 
WRITE CMNDS: ITe, WRHD 
CHECK CMNDS: WRCK 
SEEK CMNDS: SEEK, OFFSET, RECAL 
MISC CMNDS: DRESET, CRESET, SRESET, PAKACK, REL, 

. ’ SPIN, SELDRI 

DEV ERRORS: All hardware errors that resulted in an 


error report. Correctable ECC errors 
and errors that were recoverable when 
retried will not increment this count. 

CORR ECC ERRORS: oy ted of ECC errors corrected by 
software. 

DATA/OPER ERRORS: Invalid unit number errors and errors 
detected by the VERIFY statement, or 
invalid drive numbers entered by the 
operator. 

RETRYS: The number of occurrences for each of 
the siz retryable type of errors. 
Counts are maintained for DLT, OTE, 


H an ‘ 
TOTAL RETRYS: Total number of retry attempts on al] 
failing 1/0 operations. ; 
INTERRUPTS: munber of entries into the interrupt 
routine. 
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- Correctable ECC Errors 


When encountering a correctable ECC error (DCK), this 
device routine will mt pregereet correct the data. The 
contents of the ECC Position renis er (RKECPS) and the ECC 
Pattern register (RKECPT) will be used to determine the 
bits to be modified and their placement in the data field. 
After the correction has been angi ies the C ECC coun 

will be incremented and the data transfer will be resumed 
at its point of interruption. 


This automatic data correction will not be performed if 
the word length is 18 bits (FMTe2 reset), or if the user 
has entered the COROFF statement. In these cases, the DCK 
will be treated the same as the other retryable errors. 


- Retryable Errors 


| 
| Siz errors are classified as retryable By this device 
routine. When one occurs (DLT, OTe, HVRC, FER, DCK, or 
), the retry count contained in the interface word RTRY 
is checked for a zero value. If zero, an 1/0 Termination 
error is reported. If non-zero, the retry count for the 
error and the total seten error count are incremented ty 
one and the 1/0 operation is re-issued. If the retry is 
successful, the program will proceed to the next statement 
in the user’s progran. If it was not successful, the 
cetre count from RTRY is decremented, the total retry 
count is incremented, and the command is re-issued. is 
continues until either the retry is successful or the RTRY 
count gees to zero. When the latter occurs, the 
“EXHAUS RETRIES error message will be issued and the 


DEV error count will be incremented. 


| When processing retries on failing I/0 operations, the 
original function will just be re-issued. The use of 
Offset and Recalibrate commands are not employed during 
error recovery in this device routine. 


- Dual Controiler Operation 


This device routine supper ts operation of disks connected 
to two systems through the dual controller option. If the 
disk is wey on the other controller when the device 
routine attempts to issue an 1/0 Operation, it will 
receive a drive not available (bit O in RKDS will be 
reset). In. order to make efficient use of the disk on a 
dual controller system, both programs operating the disk 
should issue Release commands through use of the REL 
statement provided by this device routine. 


Se 
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Instructions And Interrupts 


Certain of the 1/0 functions for the RKO& disks do not 
normally terminate with interrupts and will not have 
Interrupt Enable set when —_ are = issued. These 
functions are termed Non-Interrupt functions and are: 


pres! Unt Geb SRESET 
UNL SPIN 
REL SELDR 


After issuing the above functions, the device routine will 
wales a few microseconds and then check the status of the 
error bits. Any found to be set will be reported as a 
Non-Int Termination error. 


The remaining I/70 functions, which are listed below, 
utilize interrupts in their operations: 


READ WRCK OFFSET 
WRITE BADSEC RECAL 
RDHD SeEK WRHD 


For the above instructions, tests for error conditions 
will be made when the terminating interrupt is received. 


Accessing The Data Buffer Register 


The contents of tne Data Buffer (RKDB) register will be 
stored only when recession an interrupt with the Output 
Ready (OR) Bit set in the RKCS2 register. At all other 
times, this register will not be read and its contents 
will be displayed as O’s. 


OPSW Special Operation Bit Support 


Bit 7 of the OPSW (SPOPER) is not supper ted by this device 
routine and its setting has no effect on disk operation. 


14 


M.P.G. Page 182 






eee ee 


1S 


M.P.G. Page 183 


D.14 - RKOG Device Routine (Cont'd) 


0.14.2 


DESCRIPTION OF RKO& INSTRUCTIONS 


The RKOG Device Routine pepper ts execution of thirty one MPG 
language statements. or certain functions (REHO, WRITE, 

a an ), the desired disk address must be 
loaded inte CYL an CT before performing those 
functions. In the following escriptions, data shown 
enclosed within parentheses Indicates the default values if 
nothing is entered for the statement’s operands. The v is 
used to indicate a variable operand as defined in Appendix 
B.2. Note that if an odd byte count is Sapgtter in any of 
the ae instructions except ROHD, will effectively 
be decremented by 1 before being used. 


READ (DeS6 INTO ROIO) 
READ v (INTO RDIO) 
READ v INTO v 


This instruction transfers the number of bytes, 
indicated by the first v, from the disk to memory 
pogtastes at the memory location specified by the 
second v. 


WRITE (D2S& FROM WRIO) 
WRITE v (FROM WRIO) 
WRITE v FROM v 


Transfer the number of bytes from memory to disk 
beginning at the ay location indicated by the 
second v. This command will not allow transfers to 
write data onto the last track of the disk (see 
description of command § for further 
information about this last track.) 


The following statements do not have default values for their 
operands: 


RDHD v INTO v 


Reads the three words of sector header data into 

memory using the Read Header command. In order to 

read a complete sector, the myte count must be 20 or 
, for 20 or c2 sectors per track. 


Performs a format type of operation by weiag the 
Write Header comming to write the hedder words on 
disk. The device routine sets up RKWC to be -60 or 
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“66, for 20 or 22 sectors per track. The data is 
urilten on the disk from the address specified by v. 


If this command is used, the standard format program 
cate pe used to recreate valid header data on the 
isk pack. 


WRCK v AT v 


Compares the number of data field bytes in memory to 
those at the specified disk location. Uses the 
Write Check command. 


Performs a seek function to the disk cylinder 
specified by . This instruction does not 
terminate until] the seek is finished. 


nat following 1/0 commands do not utilize the contents of 


OFFSET v 


SELDRI v 


, and SECT in their operations: 


The least significant eight bits of the quantit 
specified by v will be loaded into the lower byte of 
the Attention Summary and Offset register. The 
offset command will be used. Examples Of the o'fset 
obtained with different octal values of v are: 


v Microinches 
010 +200 
210 -200 

+400 
220 -400 

+600 
230 -600 
040 +800 
240 -800 
060 +1200 
260 -1200 


This statement issues the Select Drive command. The 
operand v is the number of the messages A and B to 
be returned by the drive and has values cf O-3. The 
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RECAL 


CRESET 


DRESET 


SRESET 


PAKACK 


REL 
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Message-A will be stored in the MSGA interface word. 
ae POaeneeD will be stored in the MSGB interface 
word. 


Places the drive in the Standby state by issuing the 
Unload command. This command is terminated as soon 
as the Unload begins. 


Starts the spindle 
command. This 
drive 1s on line. 


orem the Start Spindle 
command is not t 


erminated until the 


Results in the Recalibrate command being issued. 
pais command is not terminated until the drive is on 
ine. 


erforms a controller clear function 
CLR bit in the RKCS1 register. 


This statement 
by setting the 


mpegetocnieg of the drive 1s accomplished _ this 
statement’s issuing of the Drive Clear command. 


Performs a subsystem clear function by the 


setting 
SCLR bit in the RKCS2 register. 


Causes the Pack Acknowledge command to be issued. 


Causes the drive to become deselected and releases 
the drive for another port by setting the RLS bit in 
the RKCS2 register. 


1S 


! 
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The following instructions do not perform 1/0 operations: 


STEPUP v 


STEPON v 


This command does not perfora any 1/0 functions. It 

rovides gany 5 tg of the contents of CYL 

AD, and SECT. The operand v is the number of 
sectors that these values are to be incremented. 
When the SECT word exceeds its maximum valid value, 
it will be set to O and the contents of HEAD will be 
incremented. When HEAD overflows, it wil] be set to 
O and CYL will be incremented. 


The last track available to this command has an 
address of cylinder 410, head 1, and sector 21/19. 
This is not the last track on the disk. The last 
track has an address of 410,2,21/19 and is not 
accessed via this command; this track contains data 
about the disk pack and must not be changed with MPG 
software. The operand v may be of _ value allowed 
by the disk hardware. IT this command recognizes 
that the last track would be included in the 
transfer, it forces CYL, HEAD, and SECT to be O. 


Automatically adjusts to the number of sectors on a 
rac or ) based upon the current setting 
defined by the FMTCO/FMTce statements. 


Note that this instruction and STEPON will operate 
with invalid values in CYL an upon 
execution. Regardless of their initial contents, 
the contents of all three words will be valid when 
this instruction completes. This allows the use of 
the Te AT CYL WITH RANDOM statement followed 
by “ST to generate random disk addresses. 
However, one-sector transfers (Sle bytes) should be 
used to avoid any pogeibi tite of the Ag hr being 
pees tee us to transfers trying to write data on the 
ast track. 


Similar to STEPUP but provides a decrementing 
capability. The operand v may be of ony value 
alfowed by the disk hardware. If this Command 


recognizes that the transfer would begin below a 
disk address of 0,0,0, the disk address is forced to 
be 410,1,21719, and the decrementing resumes from 
that address. 


a i ee es eee ee. ss 
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Standard implementation - see section 0.1.1. 


WAIT | 
Standard implementation - see section D.1.1. 
NOWATT 
Standard implementation - see section 0.1.1. 
STATUS 
Standard implementation - see section D.1.1. 
Included with the standard a da is em ap seie of 
the current contents of dye d 4c T 
words. These values do m rine — asad 
osition of the disk, but merely the contents of the 
hree words. 
COUNTS | 


The following statements define to the Device Routine the 
desired settings of certain bits in the device registers. 
These statements do not gbgregiatets a the paptsite 14} 
but all subsequent 1/0 functidns and other app licable 


statements will be performed with the bits set as defined. | 
! 
FMT22 
Sets the number of secters on a track to 22 and the | 
number of bits in the data field words to jo. F FMT22 
is the preset mode and results in the CFMT bit in 
the RKCS1 register being set to a l 
FMT20 
Sets the number of sectors on a track to 20 and the 
number of bits for the data field words to 18. 
Resets the CFMT bit in RKCS1 to a O 
obd 


Causes the Parity Select (PAT) bit in RKMRI to be in 
the O state on stbsequant functions. (Preset mode) 


~-—-— + - ee - oe 
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EVEN 
Causes PAT to be set to al. 


BAION 
Specifies that bus address incre 
performed by setting the BAI 
register to al. 
BAIOFF 


Results in BAI being reset to a O 
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+ is not to be 
1 


in the RKCS2 


and bus address 


incrementing being performed. (Preset mode) 


CORON 
This statement activates the 


device routine’s 


programmed function of correcting data on which a 


correctable ECC error was detected. 
detects an error and determines 
will erform the 


corrected, the device routine 


When the disk 
that it can be 


correction procedures, increment the C ECC error 
count, and continue running. (Preset mode) 


COROFF 


Disables the programmed recovery of correctable ECC 
n 


errors. Whe 
error display will resu 
on retries. 


BADSEC 


his type of error is detected, an 
unless it 


is recoverable 


This command causes a list of the sectors, which are 
flagged bad by manufacturing, to be printed on the 
é 


LIST device. 
systems are not printed. 


sectors flagged bad by operatin 
$e satarnatie , ; 


this command is taken from the first ten sectors on 


the last track on the disk. 


mm nc = i eee er ee ee ee ee ee een. 
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D.14.3  RKO& ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section D.1.2. However, due to the nature cf 
this device, additional information is provided to the user. 


execute in two es. The first is the time it takes to 
housekeep the disk. The second is after the point the 
specified function is issued and until after the function 
terminates. Since error conditions may occur in either 
| stage, this device routine indicates which stage it was in 
! when the error was detected. This is pegenys tener by 
including the appropriate message of the following two 
messages in the error display: 


BEFORE ISSUING I/0 CNND 
AFTER ISSUING I/0 CMND 


If the error is detected before issuing the specified 170 
command and MPG’s Continue (CONT) Command is issued, the 
program will be resumed at the statement on which the error 
was detected. If an AFTER error, the program will resume at 
the next statement in the user’s program. 


The 170 furction type of instructions are considered to 
stag 


The following message may also be printed: 


ERROR BITS: 
ddd,ddd,ddd,ddd,ddd,ddd,etc. 


This message indicates that one or more error status bits 
have been detected in the device registers. The codes ddd 
identify which error bits were found. A oiste four byte 
field will be used to list all or as many of the error bits 
as possible. In the polloutng list. some codes are 
distinguished by an asterisk (#). These codes will be 
included in the aegtene if their bit values are QO. All other 
codes are included if they have a value of 1. The following 
are the mnemonic codes supported for the ddd fields: 


SS eee 


CERR = Controller Error 

SPAR = Serial certs Error 

CTO = Controller Timeout Error 

DLT = Data Late 

WCE = Write Check Error 

UPE = Unibus Parity Error 
NED = Nonezistent haw | 
NEM = Nonexistent Memory 
a = Program Error 


Mul igte Drive Select 


Unit Field Error | 
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Write Locked 
rive Read 
Volume Valid 

DROT = Drive Off Track 


25 


DSL = Drive Speed Loss 
ACLO = Drive Low 
DOCK = Data Check 
UNS = qoeete ' tel 

= Operation Incomplete 
ore = ppera {aia ilar 
WLE = Write Lock Error 
IDAE = Invalid Disk Address Error 
COE = Cylinder Overflow Error 
HVRC =H ader VRC Error 
BSE = Bad Sector Error 
ECH = ECC Hard Error 
DTYE = Drive Type Error 
FMTE = Format Error 

= Drive Parity Error 
NXF = Non~ezecutable Function Error 
SKI = Seek Incomplete Error 
ILF == I] legal Function 
ATA7 = Attention Active Drive 7 
ATA = Attention Active Drive & 
ATAS = Attention Active Drive 5 
ATAY = Attention Active Drive 4 
ATAZ = Attention Active Drive 3 
ATA = Attention Active Drive 2 
ATAL = Attention Active Drive 1 
ATAD = Attention Active Drive O 


The unique error messages, which may occur in the use of this 
device routine, are as follows: 


DATA ERROR (STMNT # nnnn) 
Standard implementation - see section D.1.2. 


EXHAUSTED RETRIES 


Upon Seton tig one of the siz retryable errors, the 
device routine has re~issued the failing 170 
operation the number of times ageci fice in’ RTRY 
without successful completeion of the operation. If 
RTRY is initially O, this message will not occur. 
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INT WITHOUT ATA 
This message indicates that gn interrupt was 
received without the drive’s ATA bit being set when 
it was expected to be set. 

INT WITHOUT DI 
This” aeveens ab oy thet an Anterrupt was 
received without the DI bit in the RKCS1 being set 
when it was expected to be set. 

INV ECC BIT PATTERN 
When ready to apply the correction to the data on a 
correctable ete error, the RKECPS Bit Pattern 
register was found to contain all O’s. 

INV ECC BIT POSITION 
When ready tc apply the correction to the data on a 

EC RKECPT 


correctable error, the PT Bit Position 
register was found to contain a value greater than 
octal 10041. 


The current unit number, which is ding] oye in 

octal, is not in the range of O-7. The ASSIGN 

command may be used to correc the erroneous unit 
c 


number. Increments the data/oper error count. 


1/0 TERMINATION ERROR 


Error bits have been detected in the device 
registers when presesaios a termination interrupt. 
This message occurs for all non-retryable errors and 
retryable errors when RTRY is set to 0 


NON-INT I70 TERMINATION ERROR 


Error bits were found set in the device registers a 
few microseconds after issuing one of the 
’ 


f 
Bea~taterrag’ type of 170 functions (PAKACK, REL, 
etc). 


INV UNIT 8 | 
| 
| 
| 
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TIMEOUT ON 1/0 


After initiating an 1/0 operation, the terminatin 
interrupt was not received. The time allowed fo 
the interrupt to occur is spgrostestuss ten seconds 
when on the PDP-11/4S and with no other user 
programs executing. 


T/0 ON CRESET 


This error, which indicates that Ready (RDY) did not 
set within a few milliseconds after setting the CCLR 
bit ‘9 RKCS1, may occur when the CRESET statement is 
issued. 


T/0 ON SRESET 


This error, which indicates that Ready (RDY) did not 
set within a few milliseconds after setting the SCLR 
bit + RKCS2, may occur when the SRESET statement is 
issued. 


T/0 ON REL 


This error, which indicates that Ready (ROY) did not 
set within a few milliseconds after setting the RLS 
bit + RKCS2, may occur wher the REL statement is 
issued. 


UNEXP ATA COND 


When processing an interrupt after josuing an 170 
function that Should not cause an ATA condition, the 
disk’s ATA bit was found set. 


UNKNOWN ERROR CONDITION 


If the CERR bit of RKCS1 is set, the program 
examines the various error bits to determine the 
cause of the error. If no other error bit is found 
to be set, this message is printed. 


SVAL BIT NOT SET IN RKDS 


When interrupts are serviced, the SVAL bit of RKDS 
is checked. If the bit is reset, this message is 
given. This message is not printed if the interrupt 
is the 2nd one from a SEEK, OFFSET, or RECAL. 


| 


| 
' 
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OUTPUT NOT READY ON ROWD COMMAND 


When the RDOHD command is executed, the OR bit of 
RKCS2 is checked. If the bit is reset, this message 
is printed. 


SELDRI COMMAND HAS INVALID CODE 
The operand entered for the SELDRI command is 
checked for a value of 0, 1, 2, or 3. If the value 
is not in this range, this message is printed. 

CTORS (OCTAL DATA) 

S AN ALIGNMENT PACK 


SI 
0 IS TOO SMALL FOR “BADSEC” COMMAND 
T READ LAST TRACK 


a fh 


These messages may be printed when the BADSEC 
command is executed. Each message describes the 
condition which caused it to occur. 
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D.14.4 


-- - SS 


RKO& SAMPLE PROGRAMS 


The obey are sample RKO& programs that perform the 
functions indicated in their descriptions: 


1. The “eo program will verify all tracks on the entire 
disk 1 ting 1 bits to the Gata fields. Retries will 
i 


be inhibited so as to isolate marginal tracks: 
#ENTER 1 AS TRKCK 

°ASGN DEV: RKOb,O 

°RDIO = 256 / 0 

°WRIO = 2S6 / S632 

°DEV REG = 177440 / 

?INT VEC = 000210 / 

"BUS REQ =S / 

ENTER STMNT’S 

0010 RTRY WITH 

> FILL DS632 AT WRIO WITH 177777 
>0030 WRITE DS632 FROM WRIO 

0040  WRCK AT WRIO 

»0050 = ST Dil 

0060 + IF 6 AT CYL <> O GOTO 30 

»0070 END 

»DONE 

#RUN 1 


2. Do 200 pairs of random seeks to an RKO& disk by using the 


STEPUP instruction to generate valid disk addresses from 
random data. Interspersée other instructions to perform 
data transfers of random data and do data validation at 
these disk addresses: 


?ASGN DEV: RKO6.S 
*RDIO = 256 / 512 
°WRIO = 256 / Sle 


ENTER STMNT’S 

0010 LOAD TMOO WITH D200 

»0020 FILL 6 AT CYL WITH RANDOM 
>0030  #STEPUP O 

>0040 MOVE & AT CYL TO TMO3 

»00S0 FILL OSle AT WRIO WITH RANDOM 
»>0060 SEEK 

0070 WRITE 0512 

»0080 WRCK DSl2 AT WRIO 

»0090 FILL 6& AT CYL WITH RANDOM 


a a + ee ee 
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RPO2/RPO3 DISKS’ DEVICE ROUTINE 


The RPO2/RPOS Device Routine, whose filename is TR3Anm. MPG, 
supports the operation of and disk drives on the 
standard RP11 controller. 


This Device Routine will automatically adjust ight 5 
based upon the device assigned to it. For the it will 
adjust to a maximum of 406 cylinders. 


PRESET VALUES AND SUPPORT SUMMARY 
- Valid Mode] Names and Unit Numbers 


In reply to the “ASGN DEV:” message, two model names (RPOC 
and ) are acceptable and may be accompanied by a 
mazimum of 16 unit numbers. For this device each unit 
number must be in the range of O thru 7 


- Interface Addresses 


The following are the values preset for the RPO2/RPO3 and 
may be altered from the console terminal following the 
“Aeon DEV:" message: 


Device Register Base Address = 176710 
Interrupt Vector Address = 254 
Bus Request Priority = 5 


- Symbolic Register Names 


The symbolic names listed below may be used to reference 
the Beo2 /RPO3 device registers in MPG instructions. The 
octal displacement associated with each name is the value 
that will be added to the device eagpeter base address to 
obtain the actual memory address of the desired register. 


Name Disp] Register 

RPOS +0 Device Status 
RPER +2 Error 

RPCS Baal Control and Status 
RPC +6 Word Count 

RPBA +10 Bus Address 

RPCA +12 Culinder Address 
RPDA +14 Oi sk Address 

RPM1 +16 Maintenance 1 


+20 Maintenance 

+22 Maintenance 
SUCA +24 Selected Unit Cylinder Address 
SILO +26 Silo Memory 


| 
| 
| 
| 
| 
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- Supported Instructions Summary 


The following is @ summary of the instructions supported 
by MPG for e - Detailed explanations are 
listed in section 0.15.2. 


Si x eS oem 
RCAC ll NOWAT 
IDLE 
CRESE 


T 
| WRNOSK MODE1O STATUS 
WRCK T  STEPUP COUNTS 


Certain of the above instructions control the setting of 
internal otes bits. The preset states of these bits are 
the same as though the following instructions were issued: 


- Information Words 


The siz words listed below are used to pass information 
between the user program and the device routine. All 
words are preset to O’s except RTRY which is preset to 3. 


CYL Aone word location that contains the cylinder 
number in bits O - 8 that will be used in subsequent 
I/O operations. The contents of CYL will be loaded 
into RPCA for all I/0 operations that require a 
cylinder address. 


HEAD The word location that follows CYL and contains the 
value of the head (track) number to be used in bits 
- The value in this word and in SECT will be 
merged and loaded ints RPDA for all I/0 operations 
that require a heat and sector address. 


SECT This word contains the sector number in bits OQO-4. 
Located immediately following HEAD in memory. 


RTRY This word opens Cine the number of additional 
attempts that the Device Routine will try on an [70 
operation before deciding that it is unrecoverable. 
Applicable only to those types of errors that 
normally have a possibility of recovery. 


SIZE Standard implementation - see section O.1.1. 
woateats are updated by READ, WRITE, RONOSK, WRNCSK, 
an . 


ERR Standard implementation - see section 0.1.1. 
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Statistical Information 


Through use of the COUNTS statement and the REPORT 
command, statistical information for the program can be 
rint device. This Tntormation 


epreee on the 
consists of octal formatted +g counts under different 


catagories. The catagories and the functions from which 
data will be included under each are: 
BYTES RD: HN RDNOSK 
BYTES WR: WRITE, WRNOSK 
BYTES CK: WRCK 
READ CMNOS: RONOSK 
WRITE : WRITE, WRNOSK 
CHECK : 
SEEK CMNDS: SEEK, HOMESK, RECAL 
MISC CMNDS: IDLE, CRESET 
DEV ERRORS: All hardware errors that resulted in an 
error report. Errors that were 
recoverable when retried will not 
increment this count. 
DATA ERRORS: Invalid unit number errors and errors 
detected by the VERIFY statement. 
RETRYS he number of occurrences for each of 
the five retryable type of errors. 
Counts are maintained for TIMEE, CSME, 
. » an . 
TOTAL RETRYS Total number of retry attempts on all 
failing 1/0 operations. 
INTERRUPTS Number of entries into the interrupt 
routine. 
Retryable Errors 
Five errors are classified as retryable by this device 


routine. When one occurs (TIMEE, r , or WCE), 
the retry count contained in the interface word RTRY is 
checked for a zero value. If zero, an 1/0 Termination 
error is reported. If non-zero, the retry count for the 
error and the total retry error count are incremented by 
one and the 1/0 operation is re-issued. If the retry i8 
successful, the program will proceed tc the next statement 
in the user's grogréa. If it was not successful, the 
retry count from RTRY is decremented, the total retry 
count is incremented, and the command is re-issued. his 
continues until either the retry is successful or the RTRY 
count goes to zero. When the latter occurs, the 
“EXHAUSTED RETRIES” error message will be issued and the 
DEV error count will be incremented. 
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- Disk Types 


This device routine does not interrogate the Device Status 
register to determine which type of disk it is operating 
on. It relies solely on the model number assigned to the 
progras. If an has been peonenes but it is actually 
an , the device routine will process it as an RPO2. 


- Accessing The Data Bulfer Register 


The Data Buffer (RPOB) eogneter will not be accessed by 
this device routine and therefore will not be included in 
any displays. 


- OPSW Special Operation Bit Support 


Bit 7 of the OPSW (SPOPER) is not supported by this device 
routine and its setting has no effect on disk operation. 


DESCRIPTION OF RPO2/RPO3S INSTRUCTIONS 


The RPO2/RPOS Device Routine supports execution of ge MPG 
jaaguage statements. For certain functions (READ ITE, 
, and SEEK), the desired disk address must be loaded into 
CYL, HEAD, and SECT before performing those functions. For 
« RDNOSK and functions, CT must contain the 
desired sector number. 
In the following descriptions, data shown enclosed within 
parentheses indicates the default values if nothing is 
entered for the statement’s operands. The v is used to 
indicate a variable operand as defined in Appendix B.2. Note 
that if an odd ou*s count is pupestee in any of the following 
instructions, it will effectively be decremented by 1 before 
being used. 


READ (D2S6 INTO RDIO) 
READ v (INTO RDIO) 
READ v INTO v 


This instruction transfers the number of bytes, 
indicated by the first v, from the disk to memory 
begs anieg at the memory location specified by the 
second v. 
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WRITE (D2S6 FROM WRIO) 
WRITE v (FROM WRIO) 
WRITE v FROM v 


Transfer the number of bytes 
the 


beginning at 
second v. 


(Cont’d) 


to disk 


from pare | hy: 
ed by the 


memory location indic 


The following statements do not have default values for their 


operands: 


RDNOSK v INTO v 
Similar to the READ statement but issues the Read 
(No Seek) command and does not have default 
operands. Reading will begin on the prersect es 
selected head and the sector 


currently specifi 


cylinder and at 
ed by SECT. 


Note: The use of RDNOSK and WRNOSK should be avoided 


when executing oer siete rograms on the same 
drive. In this situation I/O operations are 
interlaced and since these commands do not 
perform implied seeks, another program ma 


position the drive to ac 


g tones and/or a hea 
the one desire 


other than for these commands. 
WRNOSK v FROM v 
Similar to the WRITE statement but issues the Write 
(No Seek) command and does not have default 
operonds, Comments for RDNOSK also apply to this 
statement. 
WRCK vy AT v 
Compares the number of data bytes in memory to those 
at the specified disk location. Uses the Write 


Check command. 


SEEK 
Performs a seek 
specified by CYL 
does not terminat 


function to the disk location 
, HEAD, and SECT. This instruction 
é until the seek is finished. 
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HOMESK 


Performs a drive restore operation by issuing the 
Home Seek command. 


RECAL 
Identical to HOMESK. 

IDLE 
This statement perfcrms a controller clear function 
by issuing the Idle command. 

CRESET 


Identical to IDLE. 
The following instructions do not perform I/0 operations: 


STEPUP v 


This command does not perform any I/O functions. It 
presides goss ager omnes na of the contents of CYL 
AD, and SECT. The operand v is the number of 
sectors that these values are to be incremented. 
When the SECT word exceeds its mazimum valid value, 
it will be set to O and the contents of HEAD will be 
incremented. When HEAD overflows, it will be set to 
and CYL will be incremented. When incrementin 
geet the last sector on disk, all three values wil 
¢ set to O's. Automatically adjusts to the number 
of guliadere (203 for the Ape vs. 406 for the 


Note that this instruction and STEPON will operate 
with invalid values in , HEAD, and SECT upon 
execution. Regardless of their initial contents, 
the contents of all three words will be valid when 
this instruction completes. This allows the use of 
the “FILL 6&6 AT CYL WITH RANDOM” statement followed 
by “STEPUP 0” to generate random disk addresses. 


--<-- me mm wn nr a wenn rc ee ee ee ee 


+ ee — 


a | 
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STEPON v 


capability. When al] three values are O, the nex 
decrement will result a * decimal values for the 
three words of 202/405, 


| 
Similar to STEPUP but provides a egrr qoentine 
WAIT 
Standard implementation - see section D.1.1. 
NOWAIT 
Standard implementation - see section D.1.1. 
STATUS | 
Standard implementation - see section D.1.1. | 
Included with the standard sete is ths oh! sei? 
the current contents of the dvi debt 
words. These values do not * elles a pons 
osition of the disk, but merely the contents of the 
hree words. 
COUNTS | 


Standard implementation - see section D.1.1. 


desired settings of certain bits in the device registers. 
These statements do not immediately alter the ragiesee bits 


The following statements define to the Device Routine the 
but ell subsequent I/0 functions and other spel icebis 


statements will be performed with the bits set as defined 

MODE 11 
Sets the data word format to 16 bits (PDP-11 mode) 
by cosatting the MODE bit in RPCS to 0. (Preset 
mode) 

MODE 10 


Sets the data word format to 36 bits (PDP-10/15 
mode) by setting the MODE bit in RPCS to a l. 
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HDRON 
Allows for err operations on data transfer 
commands b in bath the sveneer bit (HOR) and 
the Mode bi RODE} fn CS to 1’s. 


Indicates that Header opgretions re not to be 
pec erace by resetting HOR and MODE to 0. (Preset 
mo 


| 
| 
HOROFF 
(0.15.3 RPO2/RPO3 ERROR INFORMATION 


This device routine pgopegeee errors in the standard fashion 
described in section D.1. 


If error bits are present in the device’s registers on any 
hardware error, the following message will be included: 


ERROR BITS: 
ddd,ddd,ddd,ddd,ddd,ddd,etc. 


The saver a begets? Ay +e error bits were found. A sizty 
four byte be used to list all or as many of the 
error bits “ ‘possible. In the el sewieg list some codes are 
distinguished by an asterisk (#) hese codes will be 
included in — seogsogs Be if their bit values are : All other 
codes are included i ey have a value of 1. The following 
are the mnemonic codes acleriad for the ddd fields: 


WPV = Write Protect Violation 


FUY = File Unsafe Violation 
NXC = Non-existent Cylinder 
NXT = Non-existent Track 
NXS = Non-existent Sector 
PR z progres Error 
FMTE = Format Error 
= Mode Error 
LPE = lord Parity € Parity Error 
= Word Parity Error 
SME_ = Checksum Parity Error 
. TIMEE = Timing Error 
E = Write Check Error 
NXME = Non-existent Memory Error 
EOPE <= End Of Pack Error 
OSKERR = Disk Error 
#SURDY = Selected Unit Ready 


- mm ee ee 
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#SUOL = Selected Unit On Line 

HNF = Header Not Found 

SUSI = gejeeies Unit Seek Incomplete 
= Se jected Heit File Unsafe 
= Selecte goett Write Protected 

IN7 = ttention rive 

ATTNG = Attention Drive 6 

ATTNS = Attention Drive S 

ATTNY = Attention Drive 4 

ATTNS = Attention Drive 3 

ATTNe = Attention Drive 2 

arnt = Attention Drive i 

AT = Attention Drive 


The unique error messages —_ may occur in the use of this 
device routine, are as follows: 


ATTN NOT SET 


ay message J peg that an attention interrupt 

r_RECAL instruction wae received 
without the drive's *ATTN bit aetag © set and it was 
expected to be set. Before reporting this error, it 
has been ascertained that another drive’s ATTN did 
not cause the interrupt. 
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DATA ERROR (STMNT # nnnn) 
Standard implementation ~- see section D.1.2. 


Upon detecting one of the five ine Ras + errors 
ppetenter by i t, the device routine as re-tgeees 
t ing o operation the numb times 

specified in RITRY without successfully gesgtelicg 
t ¢ operation. af Wrny is initially 0, th 


is message 
e codes for zrrzz are: 


will not occur. 


TMEE = Timing Error 
CSME = Checksum Error 
WPE = Word Parity Error 


Longi tudinal Parity Error 


LPE 
WCE Wri 


EXHAUSTED RETRIES ON xxxzx 
¢ Check Error 
| 
{ 


a a a - e  eee 


The current unit number, which is Steploges in 
octal, is not in the range of O-7. The ASSIGN 
command mey be used to re the erroneous unit 
crements the 


number. ata error count. 


Error bits have been detected in the device 
registers when processing a termination interrupt. 
This message occurs for all non-retryable errors and 
retryable errors when RTRY is set to O 


TIMEOUT ON 170 


After initiating an 1/0 operation, the peruagtens 
interrupt was not received. The time allowed fo 
the interrupt to occur is approzimately 10 seconds 
when on the POP-11/4S and with no other user 
programs executing. 


T/0 ON IDLE/CRESET 


This error, which indicates that Ready (ROY) did not 

set within a few milliseconds after issuing the Idle 
mmand, ony occur when either the IDLE or the 
SET statements are issued. 
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INV UNIT 8 
1/0 TERMINATION ERROR 


Immediately prior to initiating an I/O operation 
the Selected Unit On Line Bit (SUOL) in the RPDS 


register was found to be reset. 
UNIT NOT RDY 
panedietets te to initiating a 
e ( 


the Selec Unit Ready bi 
register was found to be reset. 


n I/0 operation 
SURDY) in the RPDS 


UNSAFE ON INITIATION 


Prior to tet Sisties ys 1/0 specation the Selected 


UNIT OFF-LINE 
/ | 
FU) in R | 


Unit Unsafe bit ( DS was found to be set. 


mn sa a ee |. 
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0.15.4 RPO2/RPO3 SAMPLE PROGRAMS 


The pte are sample RPO2/RPO3 programs that perform the 
functions indicated in their descriptions: 


all sectors on cylinder octal 123 and head 3. Use the 
PRINT instruction (8 


RON ‘DEV: REDS, 3 


display the before and after data: 


*RDIO = 256 / 60 
°WRIO = 256 / 60 

°DEV REG = 176710 / 
?INT VEC = 4 

BUS REQ = 7 
ENTER STMNT’S 

> LOAD CYL WITH 126 
) L MEAD ITH 5 


| 
| 
| 
| 1. Verify the ability to read and write the header words on 
| 


> pat apals a TA: 

> PRINT D60 AT RDIO IN OCTAL 
>0070 FILL D60 AT WRIO WITH 

>0080 WRITE D60 FROM WRIO 

>0090 FILL D60 AT WRIO WITH O 
»0100 READ D&D INTO WRIO 

>0110 PRINT #TEST HDR DATA: 

>01 PRINT D60 AT wRIS N OCTAL 
01 WRITE D&C FROM RDI 

>0140 READ D60 INTO WRIO 

¥01S0 PRINT #RESTORED ORIG HOR DATA 
>0160 PRINT D60 AT WRIO IN OCTAL 
>0170 VERIFY D&0 AT WRIO WITH RDIO 
>0180 HDROFF 

>0190 END 






ee ee ee ee 
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2. The a Sees preeres will verify all tracks on the entire 
disk by uriting’l bits to the data fields. Retries will 
be inhibited so as to isolate marginal tracks: 


#ENTER 1 AS TRKCK 
ASGN DEV: RPO2,0 
°RDIO = 256 / g 

°WRIO = 256 / $120 


ENTER STMNT’S 


#RUN 1 


3. Do 200 pairs of random seeks to an RPO3 disk by using the 
STEPLP instruction to generate valid disk addresses from 
random data. Interspersé other instructions to perform 
data transfers of random data and do data validation at 
these disk addresses: 


iS 
3 
3 


? DEV: RPO3,5 
°RDIO = 256 / Si2 
| °WRIO = 2S6 7 Sle 
ENTER STMNT’S 
»0010 LOAD TMOO WITH 
E BAT CYL WITH RANDOM 
> MOVE 6 AT CYL TO 
»00S0 FILL O0S12 AT WRIO WITH RANDOM 
»0060 SEEK 
»0070 WRNOSK DS12 FROM WRIO 
»0080 WRCK DS12 AT WRIO 
> FILL 6 AT CYL WITH RANDOM 
Ord Pregear’ YL TO 90 
>O1e0 6 af ¢ TO TNGe 
01 WRITE D512 FROM WRIO 
»0140  WRCK DSle AT WRIO | 
»01S0 MOVE 6 AT TMO3 TO CYL 
0160 READ bse INTO RDIO 
»0170 VERIFY DS12 AT RDIO WITH WRIO 
10180 MOVE & AT TMOG TO CYL 


(Cont’d) 
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i'w 
_ 


NT 
T 
0 GOTO 20 


oe 
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RSO3/RSO4 DISKS’ DEVICE ROUTINE 


The RSOS/RSOY Device Poutine, whose filename is TRSAnm. MPG, 
supports the npberetios of RSO3 and RSOY disk drives on the 
standard RH11 SBUS controller and on the 11/70 version 
(RH70) of the RH11. 


This Device Routine will aerene}tees ty adjust its operation 
based upon the device assigned to if end the CPU that it is 
operating cn. Error bits diSplayed in the ERROR BITS message 
will be applicable to the device and the controller. Error 
bits will be included as necessary for common errors and RH70 
errors. Also, two additional device registers are supported 
for the RH70. 


PRESET VALUES AND SUPPORT SUMMARY 
- Valid Model Names and Unit Numbers 


In reply to the “ASGN DEV:” message, two mode] names (RSO3 
and ) are acceptable and may be accompanied by a 
marimum of 16 unit numbers. For this device the unit 
numbers must be in the range of O thru 7 


- Interface Addresses 


The following are the values preset for the RSO3/RSOY and 
2 altered from the console terminal following the 
* DEV:" message: 


Device Register Base Address = 172040 
Interrupt Vector Address = 204 
Bus Request Priority = 5 


- Symbolic Register Names 


The symbolic names listed below may be used to reference 
the 1 ° device repteters in 

instructions. The octal displacement assdciated with each 
name is the value that will bs added to the device 
register base address to obtain the actua! memory address 
of the desired register. Note that the last two (RSAE and 
RSC3) will be supported only when running on an 11/70. 


Name Disp] Register 
RSC1 +0 Control and Status 1 
RSWC +2 Word Count 


RSBA +4 Unibus Address 


— a ee ee 
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RSOA 46 Desired Sector/Track Address 
RSC2 +10 Control] and Status 2 
+le prive tatus 


+14 rror Register 
+1 Attention Summary 
6 + ook Ahead 
« ata Buffer 
+ Maintenance 
RSOT +26 =; Drive Type 
ESRE +30 Bus Address Extension 
RSC3 +32 Control and Status 3 


Supported Instructions Summary 


The following is a summary of the instructions supported 
by for’ the RSOS/REO4. Detailed explanations are 
listed in section 0.16.2. 


READ CRESET WAIT BATON 

WRITE DRESET NOWAIT BAIOFF 

WRCK STEPUP APORT 000 

SEARCH STEPDN BPORT EVEN 

STATUS COUNTS 
Certain cf the above instructions contro] the setting of 
internal flag bits. The preset states of these bits are 
the same as though the following instructions were issued: 


WAIT 000 BAIOFF APORT 


Information Words 


The siz words listed below are used to pass informati 
between the user program and the device routine. A 
words are preset to O's except RTRY which is preset to 3 


TRAK or HEAD A one word location that contains the track 
number in bits O-S that will be used in 
subsequent I/0 operations. The contents of 

will be loaded into RSOA for al] 1/70 
operations that require a track address. 


on 
1] 


SECT This word contains the sector number in bits 
O-S. Located immediately following TRAK in 
memory. 


RTRY This werd specifies the number of additional 
attempts that the Device Routine will try on 
an I/O operation before deciding that it is 
unrecoverable. Mpg) igabie only to those 
types of errors that normally have a 

possibility of recovery. 


- ee es ee ee ee 
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SIZE Standard | tation - t 1.1, 
Contents “are updated. by READ, uate: and 


ERR Standard implementation - see section 0.1.1. 


Statistical Information 


zeroes use of the COUNTS statement and the REPORT 
commafd, statistical information for the ‘4 e can be 
peneseuee on the Ae device. This information 
consists of octal formatted binary counts under different 
catagories. The catagories and the functions from which 
data will be included under each are: 


COMMAND 
WRITE COMMAND 
CHECK COMMAND 
COMMAND 
DRIVE CLEAR COMMAND 
DEV ERRORS: All hardware errors that resulted in an 


error report. Errors that were 
recoverable when retried will not 
increment this count. 


DATA/OPER ERRORS: Invalid unit number errors and errors 
detected by the VERIFY statement. 


RETRYS: The number of occurrences for each of 
the four retryable type of errors. 
Counts are maintained for DLT, DTE, DCK, 
and WCE. 

TOTAL RETRYS: Total number of retry attempts on al] 

failing 1/0 operations. 

INTERRUPTS: Number of entries into the interrupt 

routine. 


Retryable Errors 


Four errors are classified as retryable by this device 
routine. When one occurs (DLT, DTE, DOCK, or WCE), the 
retry count contained in the interface word RIRY is 
checked for a zero value. If zero, an 1/0 Termination 
error is reported. If non-zero, the retry count for the 
error and the total retry error count are incremented by 
one and the 1/0 operation fs remissued. If the retry 18 


—D.16 = RSOB/RSOY Device Routine (Cont'd) 


M.P.G. Page ele 


successful, the — will presses to the next statement 
in the user's a ¥ m. If it was not successful, the 
re count Trom RTRY is decremented, the total retry 
count is incremented, and the command is re-issued. This 
continues until either the rates is successful or the RTRY 
count goss to zero. When the latter occurs, a 
“EXHAUS RE error message will be issued and the 
DEV error count will be incremented. 


When pr cessin ah on fetting I/Q operations, the 
original fu.ction will just be re-Issued. 


Disk Types 


This device routine does not interrogate the Drive Type 
register to determine which ype of disk it 1s operating 
on. It relies solely on the model number assigned to the 
program. If an Rso4 has been assigned but it is actually 
an , the device routine will process it as an RSO3. 


Instructions And Interrupts 


Two of the 1/0 functions for the RSO3/RSOY disks will not 
terminate with interrupts and will not have Interrupt 
Enable set when a are issued. These functions are 
termed Non-Interrupt functions and are: 


DRESET CRESET 


After issuing the above functions, the device routine will 
soiey a few microseconds and then check the status of the 
error bits. Any found to be set will be reported as a 
Non-Int Termination error. 


The remaining I/0 functions, which are listed below, 
utilize interrupts in their operations: 


READ WRITE WRCK SEARCH 


For the above instructions, tests for error conditions 
will be made when the terminating interrupt is received. 


Accessing The Data Buffer Register 


The contents of the Data Buffer (RSDB) register will be 
stored only when process jeg an interrupt with the Output 
Ready (OR) Bit set in the RSCS2 register. At all other 
times, this register wili not be read and its contents 
will be displayed as O's. 
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- OPSW Special Operation Bit Support 


Gol 
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Bit 7 of the OPSW (SPOPER) is not we ply by this device 


routine and its setting has no effec 


DESCRIPTION OF RSO3/RSO4 INSTRUCTIONS 


The RSO3/RSOY Device Routine supports execution of 
MPG poogye e statements. 
WRCK, and ), the desired disk address 
into TRAK and SECT 


following descriptions 
parentheses indicates the 
entered for the statement’s 


D.16.2 


must 


data shown enclosed 
default values if 
operands. The v_ is 


indicate a variable operand as defined in Appendix B.2. 


For certain functions (READ, 


before performing those functions. 


on disk operation. 


eighteen 


loaded 
In the 
within 


nothin 18 


use to 
Note 


that if an odd 7 ie count is cape ties in any of the following 
€ 


instructions, it will effectiv 


being used. 


READ (D2S6 INTO RDIO) 
READ v (INTO RDIO) 


y be decremented by 1 before 


bytes, 


specified by the 


READ v INTO v 
This instruction transfers the number 
indicated by the first v, from the disk to memory 
beginning at the memory location 
second v. 
WRITE ( FROM WRIO) 
WRITE v (FROM WRIO) 
WRITE v FROM v 


Transfer the number of bytes 
beginning at the 
second v. 


from memory 


to disk 


memory location indicated by the 


The following statements do not have default values for their 


operands: 


WRCK v AT v 


Compares the number of data field bytes in memory to 


those at the specified disk lofation. 


Write Check Data command. 


Uses the 


ee eee a a ee ee ee eee 
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SEARCH 


by . This instruction does not terminate until 
| the search is finished. 


The fol louion 1/0 commands do not utilize the contents of 
TRAK and SECT in their operations: » 


CRESET 


This statement ety acontroller clear function 


by setting the CLR bit in the RSCS2 register. 


DRESET 


on em 6 HS of the drive is accomplished by this 
statement’s issuing of the Drive Clear command. 


Performs a search function to the sector specified 
The following instructions do not perform 1/0 operations: | 


STEPUP v 


This command does not perform oy 1/0 functions. It 
provides easy incrementing of the contents of TRAK 
and SECT. The operand v is the number of sectors 
that these values are to be incremented. When the 
SECT word exceeds its maximum valid value, it will 
be set to O and the contents of will be 
incremented. When incrementing past the last sector 
on disk, both values will be set to O. 


| 
| 
Note that this instruction and STEPDN will operate 
with invalid values in TRAK and SECT upon execution. 
Regardless of their initial contents, the contents | 
of both words will be valid when this instruction 
completes. This. allows the use 0 the 
“PTEL 4 AT TRAK WITH RANDOM” statement followed by 
“STEPUP O” to generate random disk addresses. 

| 


STEPDN v 


Similar to STEPUP but provides a _decrementin 

capability. When both values are QO, the nex 
decrement wil] result in the decimal values for the 

two words of 63 


{ 
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WAIT 
Standard implementation - see section 0.1.1. 

NOWATT 
Standard implementation - see section 0.1.1. 

STATUS 
Standard implementation - see section D.1.1. 
Included with the standard display is the lay of 
the “current contents of the thax and see Te 
These values do not reflect the current position of 
the disk, but merely the contents of the two words. 

COUNTS 


Standard implementation - see section D.1.1. 


The following statements define to the Device Routine the 
desired settings of certain bits in the device registers. 
These statements do not _ immediately alter the register bits 
but all subsequent 1/0 functions and other applicable 
statements wil] be performed with the bits set as defined. 


APORT 
Indicates that the value of the PSEL bit in RSCS1 is 
to be set to O (UNIBUS Port A). (Preset mode) 
BPORT 
PSEL will be set to a 1 (CUNIBUS Port B) on 
— subsequent functions. 
ODD 
Causes the Parity Select (PAT) bit in RSCS2 to be in 
the O state on subsequent functions. (Preset mode) 
EVEN 


Causes PAT to be set to al. 


eee eee eee ee 
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BAION 
Specifies that bus address incrementing is not to be 
performed by setting the BAI bit in the RSCS2 
register to al. 

BAIOFF 


Results in BAI being reset to a OQ and bus address 
incrementing being performed. (Preset mode) 


RSO3/RSO4 ERROR INFORMATION 


This device routine processes errors in the standard fashion 
described in section D.1.2. However, due to the nature of 
this device, additional information is provided to the user. 


The 1/0 function type of instructions are considered to 
execute in two s = he first is the time it takes to 
housekeep the disk prior to the output of the specified 
command. The second is after the point the specified 
function is issued and until] after the function terminates. 
Since error conditions ay occur in either ates. this device 
routine bedigotes which stage it was in when the error was 
detected. his is egeenas shed by including the appro riate 
message of the following two messages in the error display: 


BEFORE ISSUING 1/0 CMND 
AFTER ISSUING I/0 CMND 


If the error is detected before issuing the specified 1/0 
command and *s Continue (CONT) Command is issued, the 
program will be resumed at the statement on which the error 
was detected. If an AFTER error, the program will resume at 
the next statement in the user’s program. 


Also included with every error display, other than the 
invalid unit number error, is the following message: 


ERROR BITS: 
ddd,ddd,ddd,ddd,ddd,ddd,etc. 


This message indicates that one or more error status bits 
have been detected in the device registers. The codes ddd 
identify which error bits were found. A oizt four byte 
field will be used to jist all or as many of the error bits 
as possible. In the poh tentang list. “some codes are 
distinguished by an asterisk [#). These codes will be 
included in the message if their bit values are O. All other 


— = 
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codes are included if they have a value of 1. The following 
are the mnemonic codes supported for the ddd fields: 


Error bits common to al] devices: 


EE ey te 


BDDYDDYMWVYMVMOVWMYD 
ee ee ee 


ATA7 


[ Lamn! 
i el oot 
nab) 


special Rpnds tien 

ansfer Error 

= Massbus Control Bus Parity Error 
he Available 


d 

= Data ‘Late 
= Write Check Error 

Unibus Parity Error 
Nonezistent Brive 
Nonezistent Memory 
Program Error 
Missed Transfer 
Massbus Data Bus Parity Error 
Attention Active 

rror 
Positioning In Progress 
Medium On-Line 
Drive Present 
Drive Ready 
Data Check 
Unsafe 
gperetion Incomplete 
Drive finjag Error 
Write Lock Error 
Invalid Address Error 
Address Feta Error 
Parity Error 
Regis ster edi (ication Refused 

¢ga 


t 
t 
t 
t 
t 
t 
t 
t 


=) 
- 
-—. 
o 
3 
D 
o 
— 
os 
< 
e 
o 
3 
< 
€ 
OF MW CUO 


te Active Drive 


Error bits unique to the RH70: 


Address Parity Error 

Data Parity Error, Odd Word 

rror, Even Word 
rror, Odd Word 
rror, Even Word 


Write Chec 
Write Check 


TL 
Oo 
Ge 
<_ 
ce 
vu 
Oa 
4 
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The unique error messages, which may occur in the use of this 
device routine, are as follows: 


DATA ERROR (STMNT ® nnnn) 


Standard implementation - see section D.1.2. 


DISK IS OFF-LINE 


Immediately prior to initiating an 1/0 operation, 
the Medium On Line bit (MOL) in the RSOS register 
was found to be reset. 


ERROR CN INITIATION 


Prior to initiating an I70 operation, a condition 
that sets the SC bit in RSCS1, other than an Unsafe, 
did not clear after five Mas to reset it. The 
error bits that caused SC to be set will be listed. 


EXHAUSTED RETRIES 


Upon detecting one of the four retryable errors, the 
device routine has re-issued the failing 1/0 
operation the number of times agseettes in’ RTRY 
without successful completeion of the operation. If 
RTRY is initially O, this message will not occur. 


INT WITHOUT ATA 


This ngneees indicates that an interrupt was 
received without the drive’s ATA bit being set, when 
it was expected to be set. This error occurs where 
a SEARCH command is issued and an interrupt was 
received without ATA being set. 


INV UNIT # 


The current unit number, which is displayed in 
octal, is not in the range of O-7. The ASSIGN 
command may be used to correct the erroneous unit 
number. Increments the data/operator error count. 
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1/0 TERMINATION ERROR 


Error bits have been detected in the device 
gpl when processing a termination interrupt. 
This message occurs for all non-retryable errors and 


| D.16 - RSO3/RSOY Device Routine (Cont'd) 
| 
| retryable errors when RTRY is set to O 


Immediately after loading a valid unit number (0-7) 
into RSCSS, the Non-Existent Drive bit (NED) in 


NON-EXISTENT DRIVE 
RSCS2 was found to be set. 
| 


NON-INT I70 TERMINATION ERROR 


Error bits were found set in the device registers a 

few microseconds after  issuin one of the 

Non-Interrupt type of I/0 functions (DRESET or 
CRESET) 


TIMEOUT ON 170 


After initiating an 1/0 operation, the terminating 
interrupt was not received. The time allowed for 
the interrupt to occur is spprozimately ten seconds 
when on the POP-11/4S and with no other user 
programs executing. 


T/0 ON CRESET 


This error, which indicates that Ready (RDY) did not 
set within a few milliseconds after setting the CLR 
bit ie RSCS2, may occur when the CRESET statement is 
issued. 


UNEXP ATA COND 
When processing an interrupt after issuing an 1/0 


function that should not cause an ATA condition, the 
disk’s ATA bit was found set. 


mS 
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D.16 - RSO3/RSOY Device Routine (Cont’d) 


0.16.4 


UNSAFE ERROR ON INITIATION 


Prior to initiating an 170 — the Unsafe bit 
(UNS) in RSER was found to be set. If the previous 
1/0 operation did not result_in an error, this error 
is reported immediately. If there was an error on 
the previous operation, a drive clear wil] be issued 
to reset the condition. is still set after 
the drive clear, this error is reported. 


RSO3/RSO4 SAMPLE PROGRAMS 
The pede Bas. sample RSO3/RSOY programs that perform the 
i 


functions in 


1. The followin 


disk 


be inhi 


cated in their descriptions: 


9 program will verity all tracks on the entire 
by writing 1 bits to the data fields. Retries will 
Bited so as to isolate marginal tracks: 


1 AS_TRKCK 


?ASGN DEV: RSOY,0 
= 256 / 


ENTER STMNT’S 


LOAD RTRY WITH O 

FILL D16384 AT WRIO WITH 177777 
WRITE D16384 FROM WRIO 

WRCK 016384 

STEPUP D64 

iy AT TRAK <> O GOTO 30 


' 


' 
| 
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D.16 - RSOS/RSOY Device Routine (Cont'd) 


2. Use eight-sector transfers to write random data on the 


disk. Read each block of eight sectors after it is 
written, and software compare the data for accuracy. 


ENTER STMNT’S 


ce WRIO WITH RANDOM 


0040 : SERIFY D2048 AT WRIO WITH ROIO 
»0060 IF 4 AT TRAK <> 0 GO TO 10 
END 


ee ee ee eee 
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APPENDIX E 


ERROR MESSAGES 


GENERAL INFORMATION 


The error messages described in this — are independent of 
those issued b the individual device routines. For a 
description of the errors produced by a pers ieaeat evice 

Leertas. refer to that routine’s section in Appendiz D - Device 
outines. 


Upon detecting i reper data entries, invalid sequences, or 
device errors will Sisptey messages on the console terminal 
that describe the nature of the error. These messages, which are 
always printed in upper case ASCII, are prefixed with the code 
#ER# so that they may be distinguished from normal console 
messages issued by MPG. 


The error messages described in this appendix . be divided into 
four classes according to the MPG component that issues them. 
These four components are as follows: 


Stand Alone Executive 

Command Processor and Control Reutine 
MPG Memory Management Version 
MPG Language Processor and Compiler 


The oe sections contain a list of the error messages that 
can be issued by each component and a description of each error. 


EXECUTIVE ERROR MESSAGES 


The following is a list of the messages that can be issued by 

MPG’s Stand Alone Executive. Each message is prefized with th 

error I.D. code of #ER# and the name of the device, when it is a 

device type ol. error, in the format of “zrrz DEY:" where rrzz 
er 


will] bee VE, FITCH, LOAD, or LST 
Message Description 
CKSUM ERR When reading a device routine or a saved 


device, the checksum byte computed on 
the rea data does not match the 
checksum byte contained in the data. 


user progr en from the LOAD or FETCH 
d 


Error Messages (Cont'd) 


DEL ERR 


DEL OLD 


DEV ERR 


DEV FULL 


END OF FILE 


FILE NOT FNO 


INSUF MEM FOR MPG 


INV CMND FOR DEV 


002 
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When deleting a user pragram, the MAP 
bit blocks were exhausted before all 
bits were processed. An illogica 
error; robably due to some type of 
device malfunction. 


MPG has been instructed to save a user 

progrem but the name which it is to be 

saved as already exists. The user must 

either re~enter the /SAVE command with a 

+} diene name or delete the existing 
1 é. 


A device error (INOP, read error, write 
protes itee etc.) has been detected on 
he indicated device. 


When attempting to save a user progran, 
either all] directory entries are in use 
or all data blocks are in use. 


Occurs when reading a file and a read 
for the next block is issued and there 
is not a next Block. An illogical error 
which may be caused by the previous 
block being read incorrectly. 


This message, which is preeeter by the 
nine character ASCII file “name 
indicates that the named file was not 
found on the LOAD or FETCH device. 


Issued for the LIST device, this message 
indicates that an error condition (out 
of paper, offline, etc.) exists. When 
the. condition is corrected, printing 
will resume automatically. 


A_ minimum of 16K words is required for 
MPG. Usless additional memory can be 
brought on-line, ws can not proceed an 
further. May also be caused by a ba 
read of the ¢ program file from the 
load device. This érror message will be 
followed by a halt. Afte taking 
corrective action, if possible, depress 
CONTINUE for a retry. 


This error occurs when a dingetory type 
of command (/LIST, /DELETE, /ZERO) 1s 
issued to a non-directory type of device 
(paper tape). 


— a + ee ee ee 
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Error Messages (Cont'd) 


INV DATA The reply for the console terminal 
constants was either not in octal format 
or its value was larger than 377 


INV DATE An incorrect reply was made for the date 
Oye The format of the repiy is 


£.3 MPG COMMAND PROCESSOR AND CONTROL ROUTINE 


The messages listed in this section occur during execution of 
user entered commands and/or user programs. Other than a couple 
of subagtions all_messages are prefizted with the error 

code of #ERE. or errors that occur on commands that may have 
multiple program numbers, the error message is gresizes with the 
program’s number in the format of ™ nan”. Also, for 
aes ~ a report invalid data, the error message will be 

an 


issue then f{cllowed by another message that displays the 
data on which the error was isle ted. 
Messages Description 
i 
Ann ADJ TO EVEN Ar octal memor dress (nannnn) for the 
ae ROM bn ory g commands was found to 


’ 
be odd. ft is adjusted to the next 
lowest even address and then used as the 
address. The #ER® code is not included 
with this message. | 


ADR > MEM An octal memory address, entered on the 
» or commands, is not within 
available memory or the range of device 

register addresses. 


| 
*AS’ NOT SPECIFIED The separator word AS was not specified 
in the /SAVE or /FETCH commands. 

| 

| 


BUF /COM NOT SPECIFIED The destination name of BUF or COM was 
not specified in the FILL command. The 
data that should be /COM will be 
displayed. 


DATA CONV ERROR Data entered by the user, which was 
expected to Be in either octal or 
decimal format, contained characters 
other than O-7 or O-39. The invalid data 
will be displayed. 


| Error Messages (Cont'd) 


DATA ERROR (STMNT & nnnn) 


DATA NOT SPECIFIED 


DOESN’ T EXIST 


INACTIVE 


IN CONTROL 


INSUF MEM FOR DEV ROUT & 


INV ADR RANGE 


INV BUF/COM 8 


INV CMND 


A data miscompare has been detected by 
the VERIFY statement in a user's 
program. 


Neither pattern, octal nor ASCII data 
was specified on the FILL command. 


A command, which performs an operation 
on an existing program, is directed at a 
program slot which does not have a 
resident program. 


A STOP, CONT, or KILL command was 
directed ata program that had not been 
specified for execution. 


The user has issued a RUN command, while 
at the user program interrupted command 
level, for a program that is currently 
running and was in contro] at the time 
of interrupt. Due to stack control, 
this an invalid operation. The STOP or 
KILL commands must be issued for the 
et ery execution resumed, and then 
another user interrupt issued before the 

command will be accepted for that 
program. 


170 AREAS 

When in the process of entering or 
pee a new progres, MPG” has 
determined that there is insufficient 
memory space available. 


The octal memory address entered for the 
device register address is not equal to 
or greater than or, for the 
toterraet vector address, is not less 
than 1 The invalid address will be 
displayed. 


The value entered on the FILL. command 
was not either O-1S for the BF operand 
or O-9 for the COM operand. The invalid 
number will be displayed. 


When scanning the keyboard data for a 
command entry, the first word of data 
does not match any command name either 
in full or the first two characters. 
The invalid command entered will be 
displayed. 


foe 


Error Messages (Cont'd) 


INV DATA = xxz...22 


INV DEV TYPE 


INV LINE 8 


INV MDL NAME 


INV NAME 


INV NUMBER 


INV PAT & 


INY PROG 8 


INY STK ADR 


INV UNIT # 


LINE # NOT SPECIFIED 
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The display of the invalid data. This 
peseeee will always be preceded by a 
descriptive error message. 


Either a device which does not have 
device routine support or the keywords 
KBOO, KYBD or LOAD have been entered as 
& program’s device "e Or, a device 
type has been entered for Save, FETC . 
or LIST and is not applicable bor those 
functions. 


The program statement line number 
entered on the RUN command does not 

match any line number in the user's 

_ ram. he invalid line number will 
@ displayed. 


The device’s mode] name entered is not 
supported by MPG. The name entered will 
be displayed. 


Te progres name entered on the ENTER, 
/SAVE,  /FETCH, or /DELETE commands 
either does not consist of 1 to 6 
moecogsere or the characters are not A-Z 
or 0-9. 


The decimal number entered for the COB 
command could not be converted to a one 
word binary number. 


The pattern number entered on the FILL 
fegacee was not either PATO thru PATS or 


The program numbered entered is mot in 
the range of decimal 1 thru 16 


The value of the stack pointer was 
greater than the maximum allowable value 
when a_user program returned contro] to 

Execution of the user program will 
be terminated immediately. 


A unit number entered while assigning a 
device is not within the range of 
decimal O thru 15 


A program statement line number did not 
follow the separator word 'AT’ in the 
RUN command. 


coe 
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Error Messages (Cont'd) 
MDL NAME NOT SPECIFIED 


NAME NOT SPECIFIED 


NO OBJ CODE 


NO PROG’S FND 


NO REPT AVAIL 


ODD ADR 


OPERAND NOT SPECIFIED 


PROG # NOT SPECIFIED 


RESTRICTED CMND 


2ND OPERAND NOT SPECIFIED 


STK TOO BIG 


HO2 
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A device’s model name was not entered in 
reply the ASGN DEV message. 


A one to six character name to be used 
as the save I.D0. was not entered 
following the separator word 'AS’ on the 
/SAVE command. 


Either the RUN command or the DISPLAY 
command with the CODE option specified a 
program which does not have generated 
object code. 


The OPSW command was issued for ali 
preer ese (program number not supplied), 

ut there were no user programs 
resident. 


The REPORT command has been issued to a 
program whose device routine does not 
support the report wee The #ER# 
code is not included in this message. 


The memory address entered for either a 
device register address or interrupt 
vector address was odd. 


An cperand was not entered for a command 
that requires at least one operand 
(other than the command I.D.). 


A program number was not entered on 
either the /FETCH or the ASSIGN 
commands. 


While entering commands at the user 
program interrupt level, a command that 

would alter the contents of memory was 
gnieree- Refer to section 4.3 for more 
etails. 


command that requires two or more 
operands did not have a second operand. 


This error occurs when & user program 
returns control to MPG and has left more 
than thirty words on the stack. Since 
space is reserved for no more than 30 
words, data would be lost for the 
program. Therefore, this is reported as 
an érror condition and the program's 
execution 1s terminated. 


| Error Messages (Cont'd) 
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UNNEC OPERAND After processing a commend, an 
unnecessary operand was found in the 
command statement. 


VLD DEV TBL LD ERR, PRESS “CONT” TO RETRY 

When attempting to read the Valid 
Devices Table file (TVDAnm.MPG), the 
handler has “es an error on the 
LOAD device. The type of error will be 
identified by a handler error moqeene 
issued before this one. Attempt fo 
correct the condition and press the 
“CONTINUE” switch to retry the read. 


"WITH’ NOT SPECIFIED The WITH separator word was not 
specified in the FILL command. 

MPG MEMORY MANAGEMENT VERSION ERRORS 

The error messages listed in this section are generated by the 


Command Processor and Control] Routine but are oo) {eanig only to 
the mare Management version of MPG (TMMAnm.MPG). They can 
y 


occur on in the sections of code that are unique td this 
version. 

Messages Description 

ADR WITHIN MPG The memory address entered for the 


rogram’s area on the ENTER, /FETCH, or 
GAIPT commands is within MPG’s program 
space. 


DESTINATION NOT SPECIFIED 
The destination for the SHIFT command 
(program number, memory address, or MPG) 
was not entered on the command. 


INSUF REGS AVAIL After loading a device routine, which 
utilizes the Unibus Map, on the ENTER or 
/FETCH commands, there were not a 
sufficient number of contiguous Unibus 
Map voajstere available to pesiete the 
program’s needs. Either other programs 
will have to be deleted or the registers 
assigned to other eresy ons will have to 
be reassigned with the UBMAP command to 
make e on contiguous registers 
available. This error aborts the ENTER 
or /FETCH command. 
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Error Messages (Cont'd) 


INSUF ROOM FOR PROG 


When using the SHIFT command to move a 
program {to a new address, the program 
would not be able to fit in the space 
available. This space is from the 


pepe? ies starting address to the next 
highest program in memory or to the end 
of memory. 


INV REG & (SHD BE 7 - 28,29,30) 


PROG AREA IN USE 


RDIO+WRIO >» 24,250 


REGS IN USE 


*TO’ NOT SPECIFIED 


The register number entered on the a 
to the Unibus Map register reques 

message was not in the range of decimal 
7 thru 30. Will also occur if two 
registers are required and 30 was 
entered or if three registers are 
required and 29 or 30 was entered. 


The memory address entered asa 
presren’s Shorting address on the ENTER, 
“FETCH, or SHIFT Commands specified an 
area which is already occupied by 
another user program. 


The combined size specified for RDIO and 
WRIO exceed the decimal number of bytes 
indicated. A program’s area, which 
Anclyges RDIO iad WRIO gennot exceed 

,2/b bytes 6 words in his 
version. 


The registers specified on the reply to 
the Unibus Map register reques' BeSepee 
are already beifig use by othér 
programs. 


The 'TO’ separator word in the SHIFT 
command was not entered. 


WARNING!! PROG 1/0 AREA > 18 BIT ADR - MAY NOT RUN 


This message can occur ents on a program 
that would normally use the Unibus Map. 
It is conditioned by 22 bit addressing 
being used and the Unibus os : not being 
used. After a program is Entered of 
Fetched or after it has been phigted to 
a new address, the end of the WR area 
will be checked to determine if it is 
grecter than octal 1000000. If it is, 

his message is issued. The pregren ma 

still run if it does not 0 If 

operations or if the 1/0 operations do 
not exceed the octal 100 address 
boundary. 


| 
| 
| 
| 
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Error Messages (Cont'd) 


E.S MPG LANGUAGE PROCESSOR AND COMPILER 


The messages listed in this section would be encountered while 
entering MPG pregran instructions from the console or retreiving 
them from the save file storage media. In addition to the 
specific messages listed below, which are ag ae by #ER#, any 
user entry that cannot be interpreted will be echoed back, 
preceded By #ER® and surrounded by question marks. 


SYNTAX ERROR ON SAVED PROG - END FORCED 


An MPG program statement that was in a proper format when 
stored on the SAVE media, was not in the groper format when 
retrieved gsing a FETCH command. An END statement was 
substituted, and all preceeding statements were compiled. 


LAST STMNT NOT AN END 


The MPG statement with the highest sequence number is not an 
END statement. This message only appears after the user 
attempts to exit using a DONE statement. Since an automatic 
Compile takes place after the DONE is accepted, the user is 
aes allowed to exit until an END statement is in the proper 
place. 


annn NOT FOUND 
The line number nnnn could not be located in response to an 
nnann DELETE statement. 

MEM LIMIT EXCEEDED - END FORCED 
The storage requirement for the program — defined 
including both the packed source statements an resultant 
ob iec® code, will exceed available es if the current 
statement is included. An END statement is substituted, and 
all previous statements are compiled. 

INV LINE # 
The first four characters entered by the user are not valid 
as a line number (not one to four décimal digits). 

CAN’T xzzx ON dddd 
The MPG instruction xzzz is valid, but is not supper ted by 


the assigned Device Routine dddd. An example of this 1s 
REWIND inStruction when a Disk is assigned. 
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NON-EXISTENT LINE REF ON LINE nnnn 


The MPG instruction with sequence number nnnn referenced 
another MPG sequence number that didn’t exist. This is the 
only error that cannot be detected when statements are 
entered, and only appears after a DONE statement, while a 
compile is in progress. 


INV FMT ON SAVED FILE 
When reading a user program file from the FETCH device, the 


end of the file has been reached and an END statement has 
not been processed. 


M02 


M.P.G. Page 232 


APPENDIX F 


USER PROGRAM SUBMITTAL FORM 


Since MPG provides the ability to generate programs designed to 
test various areas of the hafdware, it was felt that a mechanism 
was needed to distribute selected programs written by the MPG 
users. y using the pot e form, a user that writes a 
program, which he feels would be uselul to other technical 
rer teenes in the factory and/or the field, — submit the program 
o the sengqensee Group for review and inclusion jp a manual That 
consists Of a catalog of these user programs. This manual wil] 
be available through normal distribution and will be updated 
periodically. 


You, as users of MPG, are by far the best source for realistic 
user programa. Due to your detailed knowledge of the hardware 
and the obvious fact that the program would not have been written 
unless there was_ a need for it, ar! programs have meaning for 
their existence. Therefore, why not share your pet programs with 
other users and thereby reduce duplication of effort. So, keep 
those cards and letters Coming in folks. 


Since this manual contains only one form, it is suggested that it 
be removed from the manual and be copied. This way, if you later 
es a second program to submit, you will still have the form 
master. 


Please fill in all items on the form. If your rors is 
lengthy, add extra pases as needed. Or, attach a listing of the 
statements produced by the DISPLAY command. When completed, mail 
the form through internal mail to: 

DIAGNOSTIC ENGINEERING - MPG 


ML 21-4 / E10 


ED 


NO2 
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Page l of ... 
MPG USER PROGRAM SUBMITTAL FORM 


DIAGNOSTIC ENGINEERING - MPG ML 21-4 / E10 


Device Tested:......... ?.0.P.- System 
Rothar*s Remit. cccckccccscosccesusssese | 
Office Locations... wcccccescees Mail Cadet... ccsvess 


Brief descriptions of: 


A) Area of the hardware tested: 


B) Purpose of the program: 


Program Namé:.........+++--+ 
Name of associated program, if any:......--+eeeeee 
Device assigned to the program:............ 
ADIO Sises.....00- WRIO Size:........ OPSW Setting:........ 
Uses: COM......... FREE...... 
BUF /BF...... MIDL...... 
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Page vex OF oo» 
Program's Source Statements: 


(Include line numbers and use additional pages if needed.) 
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APPENDIX G 


MPG CODING FORM GENERATION 


Following this description is a short user program which can be 
used to quickly ye coding forms formatted for MPG. Its 
operation is very 3 mete and — requires NONE as the assigned 
device. he fifst statement s the bit that inhibits the 
printing of the ‘PROG COMPLE * message. The nezt two 
statements set up the Form Feed character and then issues it. 
The remaining lines aig reer tee the decimal number 10, prints it 
in decimal, spaces a line, increments the number by 10, and then 
repeats the sequence. This sample wili print line numbers 10 
thru 300. By changing the constant in line 8 any number of 
lines can be printed. This form will be directed to the MPG LIS 

soesee which is either the console terminal or optionally, the 
printer. 


0010 SET OPSW BIT 0 

0020 LOAD TMOO WITH 14 

0030 PRINT 1 AT TMOO IN ASCII 
0040 LOAD TMO] WITH D10 

0050 PRINT TMO] IN DECIMAL 
0060 PRINT # 

0070 INCR TMO1 BY 010 

0080 IF TMO1 <> 0310 GOTO O00S0 
0030 END 


eee eee | 
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APPENDIX H 


MPG REVISION HISTORY 


The first section of this er contains a summary of the 
support provided on the first release of MPG. The sarees 
sections summarize the more visable differences between eac 
subsequent release and the previous one. Where applicable, the 
user will be directed to more detailed information contained 
elsewhere in this manual. 


INITIAL RELEASE OF MPG (VERSION 8® 1) 


The first release of MPG became available from SOC in August af 
1 eing an initial release, it pepper *¢e a basic complement 
of devices and features which are listed next. 


Executives and Load Media 


Four Executives, each of which supports a different primary load 
device, were supplied on this release. The load media of the 
different versions, each of which supports the PC1I/PRI1 Paper 
Tape as secondary SAVE/FETCH devices, are as follows: 


TCMPG TC1l DECtape 
RKMPG RK11 Disk 


TMMPG TM11 Magtape 
THYPG TMOe Magtape 


Also contained in each of the Executives is the driver for the 
MPG LIST device. The different printers supported for this are 
the LP11, LSI1, and LV11. 


The MPG program consists basically of the Command Processor 
Language rocessor Compiler, and Program Dispatcher. { 
requirés 8 minimum of 16K words of memory and will support up to 
- The commands listed in Appendiz A and the user program 
statements in Appendiz B are supported by this program. 


Device Routines 


Siz full support device routines and twelve minimum support 
device routines are included on this release. The full supper! 
device routines provide dp level 1/0 statements (READ, TE, 
SEEK, etc.) for the following devices: 
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DJ11 16 Line Async Multiplexer 
OL11 Single Ling Async Interface 
eit NPR Sync Interface 

il Disk 
TC1ll DECtape 


TH11 Magtape 


The minimum support device routines provide symbolic names for 
device registers and an alterable device register base address 
for the registers. The model names for the twelve routines are: 


CD11 LPLI/LSII/LV11 
CR11/CM11 PC1L1/PR11 

DC11 RC11 

DH11 RF 11 

DN11 RP 11 

KW11 TAL] 


VERSION 8 2 RELEASE 


Version 8 2 of MPG became available from SOC in April of 1976. 
The heed | thrust of this update was toward Memory Management 
and Unibus Map support. However, additional load media and 
device routines were also included. 


Before {isting the changes for each section of MPG, it should be 
noted that ohe modificdtion pertained to all MPG sections. This 
is the oueger’s for operation on an LSI-11. All areas of 
incompatibility were modified for compatibility across the POP-11 
series of procéssors. 


Executives 


Two new versions of the Executive, each of which ag eth a new 
load medium, have been added. The names of the Executives and 
the medium each supports are: 


RXMPG RX11 Floppy Disk 
REMPG RPOY Dis 


A bug, which occurred when an LV11 was assigned as the MPG LIST 
device, has been corrected in all versions of the Executive. 
Also, all versions will now determine 1f Memory Management 13 
present and if it is, will ask if it is to be used. 


MPG Program 


With this release there are now two versions of the MPG ereeres. 
The original version has been retained and has approxima ¢ly the 
same capabilities. The second and newest version (DTMMA-A) 
includes support for Memory Management, Unibus Map, and 22 bit 


| 
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addressing. Several enhancements have been beegrgerenes into the 


inal ‘version and have also been included in the Memory 


Management version. These changes are: 


The 


The table of valid device names is no longer a part of the 
MPG progres. at al now @ separate file CTVDARO. MPG) and 
“il ¢ Toaded by immediately after the typing of _ 
itle. 


Corrected a bug with the IF instruction. 


Added the WORD instruction. This allows the user to specify 
binary code in his program. Refer to Appendix 8.3. 


When specifying @ program name, the user may now use from 
one to siz Characters. Previously, it was required to be 
siz characters. 


The FAST option has been added to _~ /LIST command. This 
results in only the filenames being listed. 


The FILL command will now accept the symbolic names PATO 
thru PATA in its agers see This provides for filling the 
buffers with the predefined bit patterns. 


Angth d é bit patt has b dded. It 
Pata Sal’ Soll esereie’hoest works.” Meler ta Appendix C.3. 


Immediately after ogdiog a device routine for a user 
program, will display its filename in fuli on the 
console terminal. 


A test is made for the Cache Memory’s Hit/Miss register and 
if found, the timing constants for the DELAY instruction and 
the 1/0 timeout will be adjusted. 


Bus addresses generated for all NPR I/O instructions and the 
an TE instructions will be two words in length. 


Memory Management version of MPG has some additional 


capabilities and some restrictions. For more details, refer to 
Section 9 which has detailed information about this version. 
brief summary of these additional features follows: 


Two additional commands are supported. The SHIFT command 
allows the user to move his progr ans round in qenere and to 
change their program slots. Th UBMAP command lets the user 
change the Unibus Map registers assigned to his program. 


An existing command has been expanded. The MM (Memory Map) 
command will now accept program numbers. When this format 
is used, additional detailed information about the specified 
programs is listed. 
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The ROM, WRM, BOC, ADD, and SUB commands will accept up to 
22 bits for their addresses and/or operands. 


- The user can now optionally specify the starting memory 
address for each of his programs. 


- The RESET and VECTOR instructions are not supported in this 
version. 


- A common trap catcher has been added. This routine will 
display tage information when traps occur at vectors 4, 
10, 34, 114, and 250 


Device Routines 


Four full suppert device routines and two minimum support device 
routines have been added on this release. Also, al] minimum 
esses device routines have been merged into one file which 
tailors itself to the specified device when loaded. 


The four new full support device routines are for the following 
devices: 


DH11 16 Line Programmable Async Multiplezer 
LPLI/LSII/LV11 Printers 

PC1LI/PR11 Paper rape Readers and Punch 
RPO4/RPOS/RPDS Disks 


The two new minimum support devices are: 


RX11/RXO1 Floppy Disk 
TMO2/TUlB Magnetic Tape 


The criginal siz device routines were modified for compatibs lity 
with the Memory Management version of MPG. Other changes tha 
were included are: 


- An 1/0 timeout error is now treated the same as other device 
errors. The user may now issue the “CONT p” command to 
resume execution. 


- A bug with the BREAK instruction for communication devices 
was Tized. 


- All device routines will display the unit number in octal 
when reporting invalid unit number errors. 


- The RK11 device routine wil] now validate the device 1.0. 
bits in RKDS on search complete interrupts. 


- The DJ11 and DLI1 device routines now keep counts for the 
number of Read and Write interrupts. 


———— o> +--+ 
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H.3 VERSION 8 3 RELEASE 


Version ® 3 of MPG became available from SOC in August of 1976. 
This release consisted of the addition of fdur new device 
routines and the firing of three bugs in the MPG programs. Also, 
a new Pattern format has been added. 


MPG Programs 


The three bugs corrected applied to both versions of the MPG 
program and are: 


- The binary code generated by the compiler for relative 
"IF" instructions (IF >, <, =), 24), contained signed branch 
instructions. These have beer changed to unsigned branch 
instructions. 


- The “BREAK v™ and “BREAK v ON v™ instructions could not be 
compiled. 


- Octal addresses entered for 1/0 instructions requiring two 
word addresses (READ, APITE, etc.), were not compiled 


properly. 


+r Pattern format (PATB) has been added and will generate the 


A 
following two word pattern: 


) 
165555 
133333 
165555 
133333 
etc. 
The Valid Devices Table file (TVDABO.MPG), which is loaded by the 
programs, has been revised to include the model names 
supported by the four new Device Routines. 


Device Routines 


Four new full support Device Routines have been added on this 
release. Their filenames and the devices that each supports, are 
as follows: 

TDUARO.MPG = DU11 Synchronous Line Interface 

TRSARO.MPG = RSO3/RSO4 Disks 

TRIARO.MPG = RPO2/RPO3 Disks 


TREARO.MPG = PKOG Disk 
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(End of M.P.G. Users’ Manual) 
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